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INTRODUCTION 


BOLT is an acronya for 31000 CneLine Tests. S30LT 13s a normatk 
State I/0 test orogram that determines and isclates the failure 
mode of a peripheral and orovides a level of confidenc2 in tha 
pertoheral after any repairs have been made. 30LT only 
implicitly tests the I/0 controts (C1.@e>» if the peripherati 
performs correctly then the control ts taplicitly functional). 
17/0 testing 1s accomplished either through pre-defined test 
sections or through 80LT*s Peripherat and Control Analysis 
Program CPCaP) feature which allows the operator to ouild and 
dispatch up to six (65) descriptors to an I/0 devicee 


BOLT ts structured as a single SOL program with one executive and 
a separate orocedure for each 1/0 device supported. S0LT is 
segmented in such a way that only the code necessary to perform a 
specific function needs to be presant In memory. 


The executive acts as the interface between the operator and the 
test sections and handtes ati solicited and unsolicited O57 
Inpute Tne executive schedules and executes test sections» 
builds and dispatches PCAP descriptors and displays error and 
status messagese 


BOLT allows only one device to be under test at atime. Multiple 
devices may be tested at the same time Dy executing multisle 
copies of BOLT. 
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DEFINITIONS 

Following are brief defiritions for some of the terms and phrases 

used in this document. 

BOLT 

Acronym for B£1000 OnLine Testse Aliso the name of the obdject 

code file that must be executed to run the executive and test 

programs. 

COMMAND 

Any valid instruction that tha BOLT axecutive can parsee Usually 

entered by the operator through the ODT. 

CONFIDENCE TEST 

Any test that attempts to operate a peripheral and control in a 
C) normal functional mannere 

CONTROL 

One or more togic cards that interface a peritoneral to a 

processore 

DEFAULT 

Refers to test parameters or test sections that are automaticaily 

used by BOLT untess otherwise specified by the operator. 

DEYICE 


A peripheral connected to an I/0 interface control. 


DIAGNOSTIC TEST 


Any test that uses diagnostic eoeration codes to attempt to 
detect and isolate control errors to an interface card ofr 
functionat logic block. 7 
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OPERATOR 


The person tnat controls the operation of 8OLT through tnput 
commandsSe | 


OPERATOR SENSITIVE 
Refers to test sections whose defauit parameters may 52 =changed 


by the operatore 


PCAP 


Acronym for Pertonheral and Control Analysis Program =~ a feature 
of BOLT that allows the operator to build and dispatch up to six 
descriotorse 


SECTION 


A functionatly complet2 suddivision of a test procedure that may 
be individually scheduled and executed by the operator. 


SYNTAX ERROR 


An error in the BOLT commands entered by the operator. 


TEST 


Usually refers to the compiete collection of sections for a 


certain type of pertpheral such as the Line Printer TEST. May 


also refer to one section or a group of PCAP descriptors buitit by 
the operator to exercise a peripheral. 


UNIT 


In most cases equivalent with Oevice.» [In BOLT» UNIT is a command 
which 18 used to gain access to a device or its entire controi. 
A device 1s usuaily selected using an MCP mnemonic such as LPA 
for Line Printer A. 7 , 
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DESIGN GOALS 


The following goals have odoeen anpnlied to the design of the 
axecutive and test routines: 
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There 1s one executive which parses all commands and contains 
the procedures that are common to ali tests. The executive 
and the test routines consist of one SDL programs where the 
tests are written as separate procedures that can be added to 
the source file. 


BOLT ais able to be afficiently multicprogrammed in 123K8 
SystemSe Tnis means that the run time memory requirements 
for BOLT should never exceed SOKB. 


The tests do not require that the system be halted or 
clear/started. 


Whenever possidles» confidence test secttons gre designed in 3 
pottom~up fashion tn which the first section executed 
performs the stimplest operations using the least amount of 
Logic. Subsequent sections rely on previously verified logic 
as much as possible. The optional diagnostic sections are 
designed in a similar manner. : 


Ali device tests use a special diagqnostic communicate to the 
MCPs which inhibits the MCP from reporting errorss retrying 
ODS» or handling excaptions when sending the descriptor toa 
the device. | 


Program input and output messages have a2 minimum Impact on 
the QDT so as not to interfere with other QnrwLine orograms 
communicating wtth the ODT. Output ts aptional to the tine 
printer or ODOT. BOLT is sensitive to non«solicited ODT input 
to alter program execution. 


Ail tests insure that they do not cause dats corruption on 
other peripherats that are betng used by the system while a 
device or interface is being tested. 


Program error and operation messages are@ maintained in 
separate fites. This witli attlow easy alterations for 
nationalistic ianguage requirements. - 
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COMMAND SYNTAX 


BOLT commands may De entered in uoper case or tower case (Clower 
case commands are converted to upper case oy the MCP). sSlanks or 
commas may be used to separate statement components. The number 
of btianks and commas is not significante Onty the first three 
letters of any command are significant for each identifier. More 
fetters may be entered for clarity. 


If a syntax error is encountered during the scanning of a 
statement» a short error message wilt appear on the ODT. The 
input Line up to the point cf error will be disptayed to help 
1soiate the syntax error. The remainder of the unscanned input 
7s discarded. Ail commands parsed correctly up to the point of 
error are executed before the error message 1s displayed. 


Numbers may be entered in either decimal or hexadecimal. An at 
sign “d" preceding and following a number denotes a hexadecimal 
valuee This is the case for numbers displayed on the QOT and 
numbers entered by the operator. 


It is vatid to transmit a blank character to the test program. 
This witl cause the program to suspend execution of the current 
section Cif one is being executed) and wait for a GQ command. 
Entering a blank 18 a quick way to cause a test to pause and 
accept new parameterse 


aazae NOTE saat 
Bott parses and executes commands until a GQ» SEND» Logical Op 
CWRITE» TEST» etc)» EXIT» CLEAR or RESTART command is entered. 


Any input . foltowing one of these commands on the same line will. 


be ignored by BOLT. For example: | 
<job #> AX UNIT MTAS SEC le 23GOsSEC 3» 4360 
would be iaeenreees. The correct entry would be: 
¢job #> AX UNIT MTAS SEC 1» 2360 
Cwatt until section PB gompleves). 


<job #> AX SEC 3» 4360 — 


Uae ai eps ete Seen Oty ees a Te eh Saieagan age SK ee, PAR thee aap eo oe a ee ee 2 rT a a ke AG A Sa ah pe MCE Pa DRE RR EEN chau IL UNE g pubes pucniboagy Ge pee AT Bite Cote) Ge DORE, Pn ee ee ES i ea acid Saar Rs kad 
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CY 
MAA gadet 


STATEMENT 


> eee cre ene ere ----- w----- <COMMAND> ceeenee-- sececo-- er eeen---- ># 
I 1 


p<eeesea= “3: SaeSsesss24 
COMMAND 
Denne nee een essen ne KADDRESS> western cen cnc cece enn e en e---->3 


[-"= <ALPHA> saaeeres-=>!1 

Ps) <300> Sees eo ssss>4 

pues <BYE> sa eaannennnn>| 

Lse= <CHAIND Sa seoess<->1 

=== <CLEAR> =<<<=ss=5551 

P—-== <COMPARE> soses--- >t 

(HS) <CYCLE> sse=sS"=454 

Teo- <DATA> secon ere=>] 

I--7 <DELAY> sse3ere--->1 

oy ' AS8= <DESPLAY> 2226-44931 
Cd l—-- <ELO0G> ----------->1 
~ | SSS KEXT > Bese sseeensot 

Pao= <G0> seer senate re=>] 

| Pom- <HALT> sescneseseo>) 
| Pees <HEX> saeeeamceena> | 
ies= <LENGIH> Ss=soc==<>1 

Pees <LINK> seecencenn->] 

=== <LOCK> Ss=ssSes=>1 

‘Tse <MAXIMUM> seeese=->] 

(<=* <O01> =sssssss<">>1 

Pore <OP> sewn tere sen==>] 

l--- <PRINTER> oneeer-=>] 

f--- <RECORDS> s<-----=>1 

Imo" <REPEAT> snenee--->} 

f--- <RESTART> soss---->1 

Lees <RETRY> secereren=>] 

[SS <SECTIUN> s=o=====>1 

f-- <SEND> swecesese==>] 

P--- <TEACH> -------- -->! 

' . PSe2 <TRACE> Se eSeees=s>] 

Pom= CUNT T> sceeescen-=>1 

CNAs SNe or a ea 


C 
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AVOREQo° see" — "== w wae <27-—BCOLC™eharacters> 4s " seer eer es >2 


| MULTILINE DEVICES QNLY 


The ADDRESS command scans off the two ES8CDIC characters enclosed 
in quotes and stores them in a variable caitled TERMINAL_ADDRESS 
which is used by predefined datacomm tests to determine which 
terminal to select. 


Examples: ADDRESS "D2" The next j§.data comm test that 
fequires aterminal address will 
use "O27 


ADD 793" Use "03" for terminal addresses 


EP TNC PD ee nis ALE AS NOME LG ehh AL OCT Ote LET ROR Tel POUR, LORE PORT RN 3 PERT NLS Bee PUTT nn PS: PR eA Ce TCA SERS OE RE SPMRS LC FD SRT OS. VEEN OP anton TRAD ans CTT VEeTIO NS TORN TTR ELA SOT SET Me OR NURS ROLE Sa GPE Wt ee 
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ALPHA+=-----~ ono------- eo ecnecee-- woecce-- eacec--- stattetetatetatetatatetT 
--- ! 

p=-- ON <--->] 
-- ! 
l--- OFF --->1 


The ALPHA command permits data to be displayed in EBscOIC 
(character) formate 3 


If this option is set when data is being displayed» the data witi- 
be displayed in ESCDIC formate 7 


This command 1s independent of the HEX commande 


It should be noted that this command does not display the data. 
It only controis the format of the data when it is displayed. 


If ALPHA is entered without the modifiers ON or OFF the oaptian 
wiiil be set one | 


Default value: OFF 


Examples: | ALP OFF Data wiii not be displayed in 
wee Ge ee —.. . £EBCDIC format. 3 
ALPHA  —..—s Data «will be displayed in EScDIC 
| formate | 


Weed wench beac abet AR Os cll lie Rae Ble ld ed Yee ial we a Anas ee wll ee 


7 ee 
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BO So nan tn ro nn nnn nn nn nr nnn nnn nnn nn nn nen nnn nnn nr en e==>F 
--- i 

[--- ON cceeeon-=>1 

-_- 

boo" OFF s"------>1 


The BQJ command causes *"Seginning of Job” and “Ending of Job” 
messages to be displayed at the start and end of alt selected 
test sectionse 


If BOJ is entered without tne modifiers ON or QFE the ootion witli 
be set one 


This command is useful when minimum number of display messages 
are desired while REPEAT is one 


Default vatue: aN 


Examples: 80J OFF BOJ and EJ messages will not ba 
| displayed. 
BOU | 30J and EOS messages witil bea 


displayed. 


sang ee i é FERRE ae PERCE: Mon cones 
Robe Sas Veta ate cae el POEL LESSEE EAS Gh cite: eee et sien eens Pata: win gy hs Oss Sats PemerC ANS ott eee! MER Oday i a et scat tens EO ta STE ETS eR RE EL oe ahr eed hale Cai ae eh bende cal Sle 
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BY Etta nn nnn ree cn nnn nn en ann ene nnn cen nen n een snen---->} 


The BYE command causes 30LT to terminatee The program will go to 
"PEND GF JOB» then be removed from the MCP job mixe If there is 
any device currently in use by 80LT then an attempt is made to 
restore the device back to 1ts normal operating condition and 
release it back to MCP controt. If the attempt fails then an 
error message is displayed tetling why and the BYE command witl 
have no effecte Otherwise» BOLT will go to EQJ as intended. 


Example: BYE 


top ehe Re Ree eee ta eat aay he Oe Ke eet ae CAP SECO RDS A NG Re Ree etek tee, oo ge day wig ow daa Wp ee pe cob ait SS gies alee Sober ng ae Mer ME Eee ap gs eng fa ee PERG be Sone Pe Cay Bug enteys ot Se Pee Re es en eS Rare a BSE : oh: 
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Cj 
CHAIN seem ewe wn ese em eee= KNUMBERD see esee ese wna ce www eee n secre nne=>¥ 


PRINTER DEVICES ONLY 


The CHAIN command is for use with the OnwLine Printer Test only. 
To run some Printer Test Sections a default data pattern must 
first have been selected. Some Printers aid in the selection of 
thas default data by providing a chain id in the result status 
field of a Test ope If the Line Printer Test cannot determine 
the proper data pattern to setect from information returned oy 
the Test ops the BOLT operator wiit be asked to select and enter 
a chain ide 3 


This command may also be used to override the data pattern 
selected by the Line Printer Test. Such an action would be 
necessary when the Test has made a wrong assumption apdout the 
chain id returned by a Test ops 


a When asked to select and enter a chain id» the operator witlt be 
- Shown a list of chain ids to select frome The chain id entered 
must be one from that liste At presents» the Line Printer fest 


supports the following character sets. 


16 CHARACTER EBCDIC 
18 CHARACTER ESCDIC 
48 CHARACTER EBCDIC 
&8 CHARACTER FORTRAN (Standard) 
48 CHARACTER FORTRAN (Non-Standard) 
48 CHARACTER 8500 
48 CHARACTER RPG 
CHARACTER ESCDIC OR BCL 
72 CHARACTER EBCDIC 
72 CHARACTER ASCII . | 
72 CHARACTER ALPHABETIZED 
72 CHARACTER NUMSERIZED 
96 CHARACTER EBCOIC 
144 CHARACTER THIALAND 


OO NOU & iN me | 


tion hin ton on da 
ov 
. 


Examples: CHAIN 1 - Select the ESCDIC 16 character set. 
_ CHAIN 13  . Select the EBCDIC 96 character set. 


F : \ : 
gy: ae 
: | 
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CLEA Rates cen cnn nn nn nnn nnn cnn cnn enn enn nnn n cnc en ee sen eee ses-->3 


The CLEAR command causes the test section that is currently 
executing to be terminated. The test program wilt return to the 
idle state. 


Ali options and vartables wiit be reset to their default . values. 
Any remaining test sections wilt not be executed. The unit 
selected to be tasted witl not be changed» but its defauit 
section list will be reloaded. 


Example: CLEAR | 


a@zaaz NOTE 222% 


Any input following this command on the sama Line wiit be ignored 


eR et mee 


Pa eo ee aoa weep geet ag 
2 aed el haves th Facer abba SF 
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Ss 
COMPARES @o=2--- <POINT> sn-ene= <POINT> sone ne een n ene ne nee ne nn->H 


The COMPARE command causes DATA areas of PCAP descriptors to ba 
compared. 


The contents of the DATA area designated by the first <POINT> 
value is compared with that of the DATA area designated by the 
second <POINT> value. The number of bytes compared are specified 


by the LENGTH value for the second (Cstandard) descriptor data 
area. ° | . _ | 


If the HEX option is set» the data will be coagpared in four bit 
quantities and the decimal position of the first "hex digit™ is 
displayed at the beginning of each line in parenthesis. Tf the 
ALPHA option is set» the data wiiit be compared in eight bit 
Quantities and the decimal position of the first “*character™ is 
displayed at the beginning of gach Line in parenthesis. If both 
the ALPHA and HEX are selected the data will ba compared in four 
bit quantitiese | : 


If the QDT option ts set then 46 characters of "EXPECTED" and 


aa "OBSERVED" data witt be displayed to the ODOT beginning at the 
C) character boundary of the data in error. If the PRINTER option 


is set then the entire data buffer is displayed to the printer. 


Compare errors are marked with asterisks (*) on the line titled 
"FE RRGRS®* for each ALPHA character or HEX digit in errore 


Examples: COM [4] £2] The contents of DATA [41] will be 
| | : compared with that of DATA [2] 
for LENGTH £4] bytes. 


EXPECTED (00011): COMPARE EXAMPLE.» THIS IS A COMPARE EXAMPLE} 


OBSERVED s BOMPARE ECAMPLE. THIS 15 A BOMPARE ECAMPLE. 
ry Wc a ar | & 


ERRORS 
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CYCLE----- sialatebatetabatatatatatatatetahatetatatatetatetatetateteatatatatatateietaneataatetaetetetaetaate ># 
--- ! 
f-<- ON s22-<--->] 
-- 4 
bons OFF -------->1 


The sequence of secttons specified in the SECTION command will be 
continuously repeated if the CYCLE command is sete 


If CYCLE is either foltowed by ON or not followed by a modifiers, 
the selected sequence of sections wilt be repeated until a 
RESTART » EXTT » CLEAR » BYE or CYCLE QEE statement is entered. 


Default values OFF 


Examples CYCLE OFF Execute the sequence of sections 
once or stoo the cycle processes 


CYCLE Execute the sequence of sections 
untii a STOP» RESTART» CYCLE OFF 
or BYE command is entered. 


The following two examples illustrate the difference deatween the 
CYCLE and REPEAT commands. _ 


REPEAT 33 SECTION 1» 33 will cause sections to be executed in the 
following orders lolels3s3r35.- 


CYCLE GQNs SECTION 4233 witl cause sections to be executed in the 
following orders <Ls3sive3risisilv3rsacsaee 


paren 


o 


vert 
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DATA ce cee se cee wwe wee eee eee nee e ee we see wee esac mec ae wa=n> > 


I-- <POINT> ==>] 


Big gan ere e nse rn n ngs emery puree peer ee 
1 4 1 
f 9 bm== <DATA GROUP> -------------------->) 0 
~f 4 _ de SNUMBER> <-> I 
i 4 bof 
7 
! 


The DATA command is used to select data patterns to be used Dy a 
test section or by a PCAP descriptor. 


The <sPOINT> modifier is used to indicate that this command 
applies to a specific PCAP descriptor. If <PQOINT> is not used 
then the data 1s. used by the current test section if it is 
sensitive to that Pataacens | 


if DATA 15 not fall cued by a data group or modifing word» the 


data area is filled with hex zeros. 


If fewer bytes of data are entered than the data area can 
contains. the test program will fill the remainder of the data 


area with a repeating pattern of the data that was entered. 


Data may be entered in hexadecimal» character data» oor constant 
data groupse The data groups wilt be concatenated and stored as 


a single data strings If a data group is followed by an asterisk 


and a numbers the data group wili be entered into the data string 
the designated number of times. Hexadecimat data must be entered 
an groups. of Six hex evguts or besse 


Only the amount oe data soaeiised by the LENGTH command will be 


usede The PCAP data buffers have a maximum size of 1024 bytes 
each. Test section data is entered using the DATA command with 
no <POINT> modifier. ing this case the data entered by tha 


operator is stored in a 1024 byte buffer catled DATA_ARRAY. If a 
test section is data sensitive» then the section will copy the. 
data from DATA. -ARRAY into its own test buffer before the section 
1s Pegs yp F * | | 
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For examples the following commands would cause the data array to 
be filled as showne DATA 32359%9A3de "Fs 

Data array = <a@23ABCEZ23ABCHZ3ABCG eececesceeclsABa 


If the modifier RANDOM ts used then the setected data buffer will 
be filled with a repeating 255 byte psuedorrandom hex stringe 


The data buffers may be fitted with a # repeating copy of a 
predefined data pattern ty entering the PATTERN modifier fotiowed 
by the desired pattern numoer.e The following oatterns are 
supported by BOLT: 


= EBCDIC sixteen character set 


PATTERN 4&4 

PATTERN 5S * EBCDIC fortycretght character set 
PATTERN 6 = EBCDIC sixty*four character set 
PATTERN 7 = EBCDIC seventy-two character set 
PATTERN 8 @ EBCDIC nitnty~six character set 
PATTERN 9 @* FORTRAN fortycteight character set 


PATTERN 10 = 8500 forty-eight character set 
PATTERN 11 = RPG fortycseignht character set 
PATTERN 13 = 0 to 255 incremented by 1 


Ail other pattern numbers are invalid and will return an error 
message if entered. 


The following data constants are supported by BOLT and their use 
in the DATA command wiil cause the corresponding EBCDIC code tos 


be stored in the DATA array: 


oT NUL s SOH. ~=STX ~~ ETX FSL 
BSL. «ENA ACK —s«éBELL NAK LF 
POL SEL FF sé  €Se DEL 
OLE ‘SUB OCCAN EM €18 oct 


pc2ssc3SsiCS 
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DATA (13 


DATA £51] 3122 


DATA 239» 


DATA RANDOM 


DATA £0] PAT 4 
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Tne default data will be used §=“£for 
the next tast section rune 


The DATA array for PCAP descriptor 
C1} as filled with hex zeros. 


The DATA array for PCAP descriotor 
£51 is filled with a repeating 
pattern of d@idde 


RS @ Sp SD" 


The DATA array for the next test 


Section will be filied with the 
repeating pattern g3E7E7EF59.~ 


The test section data array wilt 
be filled with a pseudorrandom 
data pattern. 


The DATA array for PCAP descriptor 
C01] wilt data pattern four. 


DATA SGH "D2" STX "TEST™ DC ETX 


Build a standard select message 
in the DATA array for use in 
datacomm testing. 


ee ee Gita FR OR eT Oe ee tee Bay Whe Lo ee waa ating ues ea anibe Louse SS ay Pee eae 5 
TEER ie A Re RI Be ana a tlle Latte ls wine alae el a ae OE lade ta Tie oh tone tal! wate 
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DEL A Yorec ten nt nna sna scars sce nn enna sacnncnnane anamensennnans ene =>7 


Terr <NUMSER> ===>] 
The DELAY command caus2s most 10%s to delay <NUMBER> * O21 
seconds before checking for a timeout condition. <NUMBER> may be 
specified in decimat oor hex andrepresents increments of one 
tenth of a second. 


If DELAY is entered with no parameter then it is reset to its 
default vaiue of 100 {ieee 10 seconds). 


Any test section may override the default or operator specified 
delay value for a particular I0>» but ait will oe immediately 
restored when the 10 is finished. 
Default value: 100 €10 saconds) 


Minimum value: 1 (9.1 saconds) 


Maximun vatue: 32000 (5 minutes) 


a. Examptes: DELAY 500 Set timeout delay value to 
re - 60 seconds. 
DELAY Restore timeout delay to defauit 


of 19 secondse 
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Mis ee Peer es oe Gee ee ee ee Seaton Be eee ao 


2] <POiNI> S23] 


l 

! 

i 

we" DEO ChiT Van eft ssSen Sess >I 
I 

j- <POINT> =~! 1 

i 


OPTIONS s-2eeesenene----">] 


SECTION seececenenen----->] 


SYSTEM saeee eee eennn----->] 


=. <2 j 


NIT sna see own waa weocea ==» } 


The DISPLAY DESCRIPTOR command displays the PCAP descriptor 
specified dy the indexe If no index is provided then it displays 
the TEST_LDESC currently being used by the test section. 


In the example shown belows the LINK field displays the indexs 
{#]»>» of the descriptor Linked to. A value of 7000001 indicates 
no link Is madeée The LENGTH field is the number of bytes in HEX 
(DECIMAL) specified by the LENGTH and DATA commands (C(C3_FIELD °- 
A_FIELD)/8). For example: 


S3AX DISP DESC £02 
DESCRIPTOR O 


UP s 400001 ALFIELD:  OO9BDF RESULTS 300030 

LINKS “0000001 BLFIELDs OOA3DF XRSLT1:2 0000C9000 

PRTI/CH: rae C.FIELDBs 000000 XRSLT2: 00000000 
LENGTHS 090100 (€C00256) 


The DETSPLAY OQOPTIGNS command displays the current state of ali of 
the operator selectable commands which can be turned ON or OFF or 
can be assigned a numerical vatue. Numerical values are 
displayed in decimal. 


In the eee eaitag TEST STATUS indicates whether a test section 
has been halted hefore completion with ACTIVE>s white IDOLE 
indicates that. no Section is ‘funnings 


SECTION NUMSER- is the current. section running or the next section 

to be rune REPEAT VALUE is the value setected using the REPEAT 
ys. . command. REPEAT COUNT is set to REPEAT vatue and decremented 
a | once each time through a repeat Loop. REPEAT COUNT therefore | 
fad indicates the number of time teft to repeat before comptetion. 


i eg eee ; peas Sots eae: ra ‘ : i 
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ae, RETRY VALUE is set by the RETRY command. NUMBER OF RECORDS is 
set by the RECOGROS command. 


SECTION ERRORS 15 the number of errors racorded for the most 
recent section. UNIT ERROR COUNT 15 the total number of errors 
accumulated for att sactions run sn that unit. MAXIMUM UNIT 
ERRORS is set Dy the MAXIMUM command and indicates the total UNTT 
error count for which the tast will terminate. 


DATA LENGTH is set by the LENGTH command and wili read "DEFAULT™ 
when a new unit is selected or a CLEAR or LEN ccamand 1s entered. 
This informs the test sactions to use predefined default tlengths. 
If the operator specifies a value using the LENGTH command then 
the specified value wilt be dispiayed as OATA LENGTH and if a 
test section is “operator sensitive” then the new tength value 
will be used. 


DELAY TIMECUT 18s set by the QELAY conamand and specifies tha 
amount of time in tenths of seconds that BULT wilt watt before 
reporting soft timeouts on all [0's. 


TERMINAL ADDRESS a8 set by the ADDRESS conmand. TRANSMISSION 
number 31s set ody the XMN command. These variables are used by 
the MULTILINE. 


‘. | TEST SECTION DATA wiit display DEFAULT if a UNIT» CLEAR» RESTART 
or DATA command is entered which means the test section wiil use 
a predefined default data pattern. If the operator specifies a 
vaiue for the DATA commands then the message “USER SPECIFIED" 
Wilt be displayed tn this field and those test sections that are 
"operator sensitive™ to data will use the new datae Following 15 
an example of the input and output for the DISPLAY GPTIGNS 
commands — 


L7AXDATA @i4Q3LEN 163RECORDS 4301SP OPT 


BOLT OPTIONS 


TEST STATUS2eeee0- IDLE ADAPTER SELECTED2«e- NO 

UNIT SELECTEDSeses NTA — CONTROL SELECTED? ee. YES 

SECTION NUMBER2e-. 012 NUMBER OF RECORDS:.- 00000004 
REPEAT VALUEZscees 000020 DATA LENGTHiececsees 09000916 
REPEAT COUNTS seees 000000 TEST SECTION DATA2e~ USER SPECIFIED 
RETRY VALUESseeces 000004 DELAY TIMEQUT2.ee02~. 0000100 

UNIT ERROR COUNT?. 000000 MAXIMUM UNIT ERRORS: 0000000 
SECTION ERRORS2e«e. 000000 TRANSMISSION NUMBER: 

TERMINAL ADDRESS:. _ | 


—. BOOLEAN OPTIONS? 
(+? DISPLAY: ODT =1 PRT =1 803 =O HEX =0  ALPH =1_ 
ERROR? ss LOCK=1 0 ELOG=1. HAL ERR=000 
TRACE? ss BUF. =0)—«~DESC=0) = AUDIT=0 
OTHER? = CYCL=400 HALT I/0)=1 


es ts 


Ee eR ee a ee a ee ee ee ee a oneal, 
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The DISPLAY DATA command will disolay the contents of the data 


array for the PCAP descriptor selected py <POINT>. If <POINT> is 
not provided» then the déta area of th2 current test section will 
de displayed. If the ODOT aption is set tne first 256 bytes of 
the buffer wilt c2 displayed to the ODT. If the PRINTER option 
is set then the entire data buffer 1s disolayed to the orinter. 
If the HEX option is set then tha ouffer witli 52 displayed in 
hexadecimal. If the ALPHA option is sat then the buffer will be 
displayed in ALPHA. 


The DISPLAY SECTION command witt display the current = section 
Liste 


The DESPLAY SYSTEM command will display a list of davices 
connected to the systen» along with port» channel and unit 
informatione 


IT command will display the device that has been 
ea tested by means of the UNTTI command. 


The DISPLAY JV 
selected to ta. 


Exampless DIS OPTIONS The state of ali of the operator 
| selectadle opticns wiil de 
_ displayed. 


DISPLAY DATA The contents of the test section 
data array wiii be displayed for 
LENGTH bytese 
DISPLAY SYS The List of devices recognized by 
| the MCP will be displayed. 


Ne A 
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J--- ON sa-=>1 
-- 
f=-- OFF <--->] 


The ELQS command causes error messages to De stored on the system 


disk in the SYSTEM/ELOG file under "OPERATOR MESSAGES”. Any 
resutt descriptors with exceptions will also be iogged under the 
appropriate devices An arror report may be obdtained by 
performing an ET command to the HCP. 


the option 


If EL9G is entered without the modifiers ON or OFF 


wilt be set one 


Default vaiue: OFF 


Examplass ELOG Error messages will be rauted to 
the SYSTEM/ELOG file. 


ELO ON crror messages wili be routed to 
the SYSTEM/ZELOG file. 


en ALIO e peg ea ethene 
ol ath ae eh ca Ee ee a a LU ae el 
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EX LT eeeecer ern en= SECTION sarees ccs nesen cn ne ccenncesenn cerns -->4 
--- | os. 


o> TEST c--->1 


The EXIT command causes the section or list of sections Ctest) 
that are currently executing to be terminated. The values of 
options and variaodles wili be unchanged. 


If EX] SEC is entered» then the section currently executing will 
be terminated and controt wilt oass to the next scheduled 
sectione 


If EXI TES is entered» then the current section» as well as all 
scheduled sections will te terminated. BOLT will go to the IDLE 
state and wait for operator itnstructionse 

If a &Q command is entered after an EXIT TEST command has been 
performed» the next section to be executed will be the first 
entry in the section List. 


This command has no effect if test sections are not currently 
being executed. 


Example: | EXIT SEC Terminate section currently 
executing and continue with next 
scheduled section. 

EXIT TEST Terminate alt scheduled sections 
and go to the IDLE state. 


ran NOTE Rak 


Any input following this command on the same tine witli be ignored 
by S3OLT. 


BD Ia ore agin ae A Teicha ge Sew Be me. aaa hg pe ame iets apr oe ea ey SE te se eee Se te eens pS ae BS Bc Tt ga ee fag layed Ty eg eye yg eg ONE ben See x or caidas Gio te Oe er ae rT bes aun Tp abietpieegtset bbe ee a its penn ip a PAE care ne me Eats a, EF a 
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= 
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The G9 command causes the initiation of the selected sequence of 
test sections» oor the continuation of a test section sequence 
that was interrupted by operator intervention or a HALT command. 


The UNIT and SECTION commands are used ta build a List of test. 


sections to be executed. The GJ command starts the execution of 
the selected sections. 


If a UNIT or SE€ECTION command had been entered before the §&9 
commands the execution will begin with the first section in the 
Section list. 


Examples GO 


xzaa NOTE a222% 


Any input following this command on the sama tine will be ignored 
by S8CLT. 


C) 
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HALT eee eee eee ecw ese es caste merase ewe NON Semen > ft 


--- I i I ! 
J--- ERROR ===>] J=-- ON o-2->1 

--- -- ! 

lo-- OFF <---> 


The HALT command causes the program to wait for a GQ command 
after each error check routine and/or I/0 descriptor List has 
completed. 


The HALT ERROR command causes the program to wait for a GQ 
command after each I/0 descriptor List has completed» or error 
check routine if an error condition existse 


Both options can not be selected at the same time. If one 1s 
selected» the otner is automatically turned offs If HALT or HALT 
ERROR are entered without the modifiers ON or QFE the options 
will oe set one 


Default value: OFF 
Examples: HALT BOLT witil go to an idtie state 
| after each I/G descriptor and wait 


for operator inpute 


HALT ERR ON BOLT witt goto an idte state 


after error and wait for operator 
indute 
HALT OFF No tonger halt after each I/0 


descriptor 1s issuede 


petmeay 
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HE Xana a cocceceenrnn-- slatetainetetatebatatetatabataiatetatatatetatatetatahabetetatatatabeetetaaeteeetet es ; 
--- i 

f<-- ON -2-->1 

-- 

bo-- OFF <-->] 


The HEX command permits 


format. 


data to be displayed in hexadecimal 


If this option ts set when data is betng disptlayeds the data wilt 
oe displayed in hexadecimal format. 


This command is independent of the ALPHA commands which can cause 
data to be displayed in alphabetic format. 


It should be noted that this command does not display the data. 
it only controls the format of the data when it is dispotlayed. 


If HEX is entered without the modifiers ON or OFF the ooticn will 


be set one 
Default value: ON 


Examples? HEX OFF 


| Data. “iil not be displayed in 


hexadecimal format. 


Data wili be displayed in hexa- 
decimat format. 
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asics i i : | i 
f—e~ <POINT> ==>] few" <NUMBER> e-=>] 


The LENGTH command is used to setect the length of the data 
buffer to be reads written» disptayed»s or compared for PCAP 
descriptors or test sections. 


If LENGTH is not followed by a number» the test program will use 
a default value for the data tength- If LENGTH is followed by a 
value then those test sections that are "operator sensitive” ta 
Length will use the new value specified. Sections not sensitive 
to that parameter will not be affected. , 


The <PQINT> is used to indicate that this command applies to a 
specific PCAP descriptor. If <POINT> is not used» then LENGTH 
refers to the data being used by the current test section. 


The value of LENGTH for test sections can be displayed using the 
DISPLAY QPTIONS command. The value of LENGTH for a PCAP 
descriptor can be displayed using the DISPLAY DESC (#1 command. 


Default value: Device dependent 


Minimum vatue: Device dependent 


Maximum value: Device dependent 


Examples: LENGTH 109 The test section data array length 
Wili be 100 bytes. 


LEN A default value will be used as 
the length of the test section 
data array. 


LEN £132 2302 #£#‘The data array tength wiil be 43 
| bytes for PCAP descriptor [11]. . 
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--- i I 


--- -<POINT> --->1 


The LINK command is used to link PCAP descriptors into a chain. 
The tLinking sequence is specified by a series of at least two 
<POINTI> modifiers. 


If LINK is entered without any modifiers» the Link field af each 
 PCAP I/0 descriptor is set to null. 


If LINK is followed by a singie <PQINT> modifiers» only the tink 
field in the designated PCAP descriptor will be set to null. 


Each PCAP descriptor has onty one Link fields so a command such 
as LINK £2] f1] £2] £0] would be unclear. BOLT does not know if 
the tink snould be made from descriptor 2 to 1 or from 2 toa 90. 
BOLT would store oniy the 2 to 9 Linke 


Circularty Linked ops such as LINK €0]7 £1] [£0] are not allowed. 
my A check for circularty Linked ops is done in the SEND command 
& just before the ops are dispatched. 


Examples: | LINK £2] £3] Create a link from PCAP descriptor 
, 2 ta PCAP descriptor 3. 
LINK [£5] Break the tink from PCAP descriptor 
Se 
LINK 7 Break the links of allt the PCAP 


descriptor Ss. 


LINK £31 £0] £21 €13 
Create the following Links between 

the indicated PCAP descriptors: 
3 to 0» 0 to 2s 2 to 1. 


SP ae a fs ee amas ee a Ets ee be me a Eat a ge eam etme ee a i a et OMS a Sm ae dn ad ee OM a we ~ tee OT ye ee ay gge TN re tee eae aes ae Ss any a eee i” 
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The LOCK command causes a loop to be set up from the beginning of 
atest section until the first error is detectede This toop will 
be repeated continuously until LOCK is reset» or the EXT» CLEAR 
or RESTART command 1s entered. 


Once? an error is detected» it need not be oresent for the test 
section to remain in the loop. Additicnal errors that may occur 
after the LOCK loop has begun wilh not change the LOCK condition. 


This command is useful in Locating and scoping intermittent 
errors. | 


If LOCK is entered without tne modifiers GN or OFF the option 
Will be set one 


e Default value: OFF 
a : _ 

Exampiess: LOCK The sequence of operations which 
occurred before an error was 
detected wiii be continuously 
repeated. 

LOCK OFF ‘The test section will continue 


with the next succeeding operation 
even if an error is detectede 
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Logical ops are two or three letter immediate action PAP 
commands that cause a predefined on to de sent out to the 
Selected unite #89OLT builds these cos in DESC [0]. DATA £0] and 
LENGTH £9] may obe specified by the operator if required. The 
result of the Logical command may be displayed by entering ODISP 
DESC [9]. The REPEAT and RETRY options apply to Logical PC4P 
commands in the same manner as pnystcalt PCAP commands. 


BOLT verifies that the Logical command entered 1s valid for the 
device selected. Following area the lists of commands supported 
for each devices: 


TAPE 
WRI Write RR © Read Reverse 
REA = Read SE = Space forward to EOF 
REW = Rewind TES = Test 
UNL = Untoad | WT™ = Write Tage Mark 
SPA °* Space TNR @~ Test Not Ready 
8S °° Backspace TR -* Test Ready 
BSE ° Backspace to EDF ERA = trasa 
PRINTER CARD DEVICE - MULTILINE 
TES = Test | TES - Test TES - Test 
WRI = Write REA @- Read STO = Stop 
FFD = Form Feed | WRI - Write | DSC ~ Disconnect 


SKI = Skin one Line SRE - Break 
For more information concerning the use of Loagical commands» 


refer to the 89LT product specification for the device being 
tested. 


aanx&az NOTE sw2228 


Any input following a Logical PCAP command on the same tine witi 
be ignored by BOLT. 


2 — ae _ a 
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--- ! 
po-- <NUMSER> ===>] 


The MAXIMUM command permits the operator tc set a Limit on the 


number of errors that may occur on a single unit defore testing 
if forced to terminate on that unite 


If MAXIMUM is set to zero» the program witli not check the number 
of errors. 


If MAXIMUM is entered without a number» it it assigned a value of 
zero. | 


Default value: 0 
Minimum values 0 
Maximum vatue: 8388607 


Examples: MAXIMUM O There is no Limit on the number of 
errors which a unit may receive. 


MAX 1 Qnee an error is detected during 
the testing of a units» the testing 
of that unit is terminated. 


MAX 200  Onee the nuaber cf errors detected 
on a single unit reaches 200» that 
unit witl no longer ‘be tested. 
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Both the gQ§OT and PRINTER commands provide a neans of selecting 
the destination of output nessages from the test program. 


If QOT 1s selected» output messages wilt be dispiayed upon the 
OOT. 


If both QCT and PRINTER are off» output messages will not be 
displayed. However » the test program wili display ACCEPT 
messages on the 939T when it requires information to be entered dy 


the operatore 


In some cases messages displayed on the ODT witt be condensed 
versions of those disolayed on tha Line printer. 


If O07 is entered without the modifiers ON or QFE the option will 
pe set One 


Default value: ON 


Examples: ODT ON . Dispiay output messages on the 
ODT. ; 
O0T OFF | Onty messages necessary for 3s0LT 
operation wilt be displayed upon 
the ODOT. 
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aL I 
Pees “NUMBERS See >] 


The QP command is used to select the operation code to $2 
performed when building PCAP descriptors. The SEND command 15 
used to dispatch descriptors built with the QP ccmmand. 


If OP is not followed by a numbers» it will be assigned a value af 
ZeTtare ; 


The unit field In the op code does not need to be specified since 
BOLT automaticatiy overwrites the last four bits of the op code 
with the unit number before dispatching the ope 


The <PQOINT> modifter is used to indicate which PCAP descriptor 
this command applies to. ? | 


Default values adgogdgdngndg 
Minimum values 92009000¢ 
Maximum values a@FFFFFFa@ 


Examples: OP {£0] | Use operation code 30090093 for 
| | | PCAP descriptor [01]. 


OP C11 28000008 Use operation code 38900002 for 
PCAP descriosctor (11. 


OP £53 32 — Use operation code 20090202 for 
PCAP descriptor [{(5]. 


fR@axneae NOTE egn2ee 


The operator has the capability to enter tnvalid ops which may 
cause an undefined result on the device under test. 
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i = 1 
J--~ OFF <--->] 
Both the Q0T and PRINTER commands provide a means of selecting 


the destination of output messages from the test programe 


If PRINTER 31s selected» 
the Line printer. 


file wiit be created. 


if both GOT and PRINTER are off» 
test 


displayed. However » 


output messages 
if a printer is not available» a BACKUP PRINT 


tne 


Will o2 dispblayed upon 


t 


will not de 
display ACCEP 


output 
orogran 


massages 
wiid 


messages on the ODT when it requires information to be entered by 


the operatore 
printer file. 


If PRINTER is entered without the nodifiers YN or DEF the 


Will be sat ane 
Default value: OFF 


Examples: 


PRINTER ON 


PRINTER OFF 


selecting PRINTER DFE closes and releases an open 


cotian 


Display output messages on tha 
line printer. 
The program wiit not disolay 


messages on tne tine printer. I[f 
a printer file is currently ooen» 
it wilt be closed and released. 
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RECORDS°*3-27- oe ee san nnn Seen ananasaeeanawawewseoasanaaan eacwene sso ocewna= 5 jf 


[eee <NUMBER >: S==>) 
The RECQOROS command is used for certain test sections to select 


the number of physical records to De written or read on magnetic 
tape units or the number of tines to be written to a printer 


devicee 


If RECORDS is not followed by a numbars it wili be asstgned a 
value of one. 


Default value: 1 

Minimum value: 1 

Maximum value: &388607 

Examples: REC 10 The number of records 1s tene 


RECORDS 2 The number of records 1s two. 


—_— 


Se . REC 2402 The number of records 15 54. 


O) 


Each section specified in the SE 
Ct 
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REPO AT tees e teens a sn sn nn en ne en ne ween een eeecess=-->4 
ae ] 1 


pee SNUTEC RS Fee] 


command» or each string of 
moer of times indicated ody 


CTLON 
PCAP commands will be executed tne nu 
the REPEAT command. 


For test secttons a "BOJ* message wiil be displayed only at the 
beginning of a newly selected sactione An "EQJ™ message witl be 
displayed onty when the section has been repeated tha selected 
numoer of times. Therefores "305" and "EON" will be displayed 
onty once for each unique test section selection» since they are 
independent of the REPEAT value. 

Whenever a SEND is entered for a tlinked list af physical PCAP 
descriptors» or whenever a logicat PCAP op 13 entered» they will 
be issued the number of times soecified in the REPEAT command. 


If REPEAT is entered without a numbers» it is assigned a value of 


ones which means execute tne specified operation one times 
C(Also» see tne CYCLE command) 
Default value: 1. 
Minimum value: 1 
Maximum values #2388607 
Example: | REPEAT 10900 Execute each section 1000 times 
3 when the GO command is eantered» 
or each Linked list of PCAP 
descriptors 19000 times when the 
next SEND command or Logical oo is 
entered. 


_ ete NGTE 22208 


Any input to BOLT while repeating PCAP operations will cause the 


repeating PCAP sequence to be terminated. Any input to BOLT 


while executing a repeating test section witli cause the section 


to temporarily suspend until a GQ 18 entered. The usual 3soOLT. 


commands of RESTART» CLEAR or EXIT» however» wiil cause the 
repeating Section to terminate. | 


Raat cee alee Cadet dawn od eS 


doegte iat EE, UN a a oT rating 7 Tides efeige Bisstis 
SME he Os Sk Ns OO RR i bee ue ped cate we . Bi acta Ba cag 
oes Sheek ees Aiba ciated Ae ea me et ee 
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RESTART<-= mem we oe a BRQBeaeneneneeteeeeaeaeese awe © Sa we @ 22 a DD 4) -eR om we we ae Se @2aeaqa»nwcaG @ @& saaawe >» 7 


Tha RESTART command causes BOLT to be rarninitializad. ALL 


options» values» data areas» unit lists and error totais will oe 
reset» and restart messages wili 5e displayed. 


Any unit selected with the UNIT command wiil be released back toa 
the control af tha MCP. 
Example: RESTART 


RES 


zzazxz NOTE «#228 


Any input following this command on the same Line Will be ignored 
by BOLT. 


1 Seb ase ope ee: GEA ged 2 at eG eek ee am gce | Wiig Sa ae edge a ay Pe ee ae eee _ wom 
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RETRY ca eee ener ccccnn siatatetatetatatatatetatatetaataienaatetetatetetatnenatatatae wecene- > 3 


[we= SNUMBERS eS 


Y command is used to select the number cf times that thea 
ogram witli retry an I/0 descristor if a result status 
error is detected. 


ik 
or 


4 


The orogram wiitl retry the operation the number of times 
indicated by the RETRY command. Once the result error 1s nat 


detecteds the ratries will be stopped. 


In some tast programs it 15 necessary to dispatch additional 1/79 
descriptors immediately tefore tho failing descriptor 18s retried. 
These descriptors are required to properly rewrcreate the failure 
condition. ) 


If error totals are recorded oy the test program» retried I[/9 
descriptors will not change these torsis. A unit®s error tctai 
will be incremented by one only if the failure still exists after 
the Last retry. 


if RETRY is entered without a nunders» it is assigned a default 
valuee Tha default vaiue for most devices 1s onee For the MAt 
TAPE» howevers the default value ts ten since under normat MCP 
conditions tape operations are retried this many times baforea 
errors are reported. When a different device is selected after a 
MAG TAPE» the RETRY value is reset to ones regardiass of its 


vaiue before the TAPE device was selected» 
Default value: 1 (10 for MAG TAPE) 


Minimum values i 


Maximum values 38388607 


Examples: RETRY - /0 descriptors wilt not be 
- retried. 
RET 10 - 1/0 descriptors will be retried uo 


to ten times-s. 


SE AE peta By BT ee tame nese ge 


eset een ge cy cpa ag te VeRO teh eg hn ee! eg aan es : nda eee - - ene 
4 SN ae See eat Oo Mae coe Oe ee ee Soe ee a ‘ .. Sse i gt ag Mote we wh Se he ee 2 = F ; 7 See, z x 5 Ton f : ; e E Hi eee on 
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The SECTION command buitds a tist of test sections to be 


executed. 
Section names nay be duplicated. The section designator en the 
right side cf the dash must not ba Less than that on the left of 
the dash. 


The command SECTION ALL causes all the default test sections to 
be selected. 


Whenever a UNIT command is antered» the saction List will de 
reset to its default value (Cdefault sequence of sections). The 
4 section list witt be reset to its default value if SECTTON is not 
followed by a numbers» numder range» or the ALL modifier. 


( 


The default section List will contain confidence test sections 
only. Those sections that requir? operator interaction or 
perform diagnostic testing are optional and nust be specificaily 
selected by the operator. 


A UNIT command must have been entered on the ODT prior to using 


the SECTION commande The optional diagnostic test sections 
require that the entire control be selected oefore testing» by 


using the 8OLT UNIT CONTROL command. 


ae ome <a 


Examples > — SECTION 2 Select section 2. 


SEC 1 -* 9 Setect Default Confidence Test 
. fg. Sections Lls2x»3 24569723 and Je 


SEC 42 2 2 17 Select sections 42» 2» 2 and i7ve 


SECTION ALL Select a device dependent sequence 
_ * a | of Default Confidence Test sections. 


| eee NOTE k&ak 


q . The SECTION command may not be entered while a current section is 
“in progress. The section sust terminate normally or an EXIT | 
command must be entered to bring the section to an orderly 
termination before a new section can be specified. | a 
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SENDeset ers 9= <POINT> tater nescence eneeen-- totes ences eee ce enn >7 


Pee «a 


built by tne operator to be issued. 


The SEND command causes tne sequence af physicat PCAP dascriptors 


Vaiues for OP» LENGTH» OATA and INK should be specified before 
the SEN command 15 uSeade 


The <POINT> modifier is used to indicat2 the (first PC AP 
descriptor to be sent. 


Examole: SEND [£313 Sand the selected seguencea of [73 
descriptors,» starting with 


descriptor number three. 


®@eane NOTE #@2& 


“Any input following this command on the same Lines will be 


ignored by 8OLT. 
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Entaring TEACH without any command specified» causes the test 


program to return a complet? List of all valid commands and their 
valid aboreviations in the form: 


<abbreviatiaon> €<remaining tetters>) 
For examples 


RESTART would appear as RESCTTART) 


Entering TEACH followed cy a command witli cause the test progran 
to return a descrtotion of the syntax and semantics of the 
commande. : 


entering IJEACH followed by a test name mnemonic wilt display 
brief instructions for the test and tist ati the valid section 
numbers and names- If the test name is followed by a valida 
section numbers the program will display a description of the 


test performed by that section.e 


The TEACH command requires the data file BOLT/TEACH. 30L7T may be 

run without the S80LT/TEACH file>» but the operator will bea 

notified that the file is missing when 80LT 15 started or when 

the TEACH command is entered. 

Examples: TEACH SECTION A syntax diagram for the SECTION 
command its disptayed atong with 
some examples. 


TEACH MTA A brief description of the MAG 
2 -  JYTAPE test ts disptayed specifying 
the valid section numbers and 

controlse 


TEA MT 3 A brief description of section 3 
| of the MAG TAPE test is displayed 
which includes operator sensitive 

variables. 


(i 
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[-- AUDIT ---->1 


The TRACE command causes selected information to be dispiayed 
during the execution of every PCAP and test section 1/0 
descriptor e 
If TRACE 1s selected without any modifiers then the command 
defaults to OcfSERIP 


if SUFFERS ts selected» the data buffers sent or received from 
the control will be displayed before and after each 1/0. 


If DESCRIP is selected» the I[/0 descriptors sent to the controal 
Will be displayed oefore and after each I1/U. The result status 
field wili contain the result after the operation was completed. 


If AUDIT is setected» the program OC/AUDIT wili be fired up by 
BOLT and the internal S80LT fite “*"AUDIT™ witt be opened = and 
Initialized. Every subsequent datacomm 1/0 wiil be togged in the 
AUDIT file and may be analyzed by the DC/AUDIT programe 
Diagnostic datacomm ops will not be traced by DC/AUDIT because 
they specify values in the A and 3 fistds when OC/AUDIT expects 
buffer addressese When DC/AUDIT 18 started by BOLT it wiil ask 
the operator for parameters. It is usually suffictent to enter 
IO0eDESC=1 and then END. If other options are desirede then refer 
to the OC/AUDIT program documentation. Turning TRACE AUDIT QFE 
WiLL anhnibit the recording of datacomm I/0 in the AUDIT fite. 
The AUDIT file will be closed and DC/AUDIT brought to ENDJ when 
BOLT goes to EQJ-« This option is onty used for DATACOHM testse 


Each command is independent of the others» and may be turned SON 
and OFF without affecting the other TRACE commands. However» 
TRACE QFE witl turn ati of the TRACE options off. 
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If the command 1s antered without the modifiers QN or QFE the 
option wiit be set on. 


Default values QFF 


Examples: TRACE The I/08 descriptors sent to the 
control will be dispiayed. 


TRACE SUF The data buffers transferred to or 


from the control will be traced. 


w#ezza NOTE 2222 


Gecasionally» when tracing atlarge nusber of operations (Cfor 
example when REPEAT is set)» the system may not be able to keap 
up with the display of information from J30LT and some trace 
information may be lost. Une suggestion for 24 tong saquencea of 
operations 18 to set tne HALT ootiton and enter GQ after each [7/9 
to guarantee that the system has enough time to display att the 
informatione 


The TRACE oottons may cause time crittcal tests to report errors. 
These errors should always be verified by turning the TRACE 
options OFF and rerunning the test. 


Te 
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Where 6 = A or 8. 
gd = A»e Be Cs De 
h = A» Be ececers He 
x = A= Ze» 1 = Oe 
Tne UNIT command setects the I/0 device to be tested. If a 


mnemonic is used to designate the devices it must be valid. 
Where applicable it must also be MCP compatible. 


The UNIT command resets the SECTION List to its default value. 


The CONTROL modifier is used to distinguish between the selection 
of a singte unit on a control and the selection of the entire. 


controle For MLx the CONTROL modifier selects Base card 0 if x=A 
and Base card 2 tf x=Q. For system security reasons the entire 
peripheral controt must be obtained ocefore any PCAP commands may 
be issued to a unit on that control» or before a test section may 
execute which performs diagnostic ops on the controt itsaif. 
BOLT verifies that a controt has been selected before issuing a 
PCAP SEND command. The tast routines verify that a controi has 


been selected before executing any sections that perform control. 


diagnostics. 


The ADAPTER modifier applies onty to MLx and is ignored by alt 


other devices. AQAPTER opens four units beginning with the unit 
specified by “x. | 
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If a valid unit is selected then SOLT witl attemot to gain access 
to that device through a diagnostic OPEN. However» before that 
GPEN» a procedure 1s executed to return tne currently selected 
device to its nornal operating conditions» and a diagnostic CLOSE 
is attempted oy SOLT on the device in usee If the CLOSE fails 
then an error message is disotayed telling why and the unit 
command wiil have no effects» If the CLOSE is successful but the 
subsequent OPEN Con the new device) is not» then an error message 
Is displayed telling the operator that the unit was not § secured 
for use by 30LT. 


A SECTION command must be precaded by a UNIT command. 


Examples: UNIT LPA | Setect Line orinter LPA. 
UNIT CON MT3 Select the control that tape 
drive B 4s connected to. AlLt 


drives connected to the same 
control wili aiso be reserved» 
hut ail untt ops wiit oniy goa 


to MTB. 
=~ UNIT ADAPTER MLE Select the second aultiline 
a 2 _ adapter card connected to base 


card 0. Ait four units on that 
adapter will be opened. 


C) 
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MULTILINE DEVICES ONLY 
The XMN command atltows the .onerator to specify a terminal 
transmission number for datacomm test sections that may 
optionaitty use theme 
The only valid parameters for the XMN command are "A™, "]Q", "QO# 
or "1". When any of these are entered» the USE_XMISSION_NUM flag 
is set and alternating pairs of transmisston numbers (CA and dQ» or 
0 and 1) are sent to the terminat during write operation s~« The 
terminalis will agnore the numbers except for the calculation of 
the message sCC. 
When XN is entered with no parameters the JUSE_XMISSION_NUM flag 
7 is reset and the transmission nuabers are not used. 
+ Examples AMN fi" | Transmission numbers of atternating 


~61ts land) 6(OF%s are sent te the 
terminal by those confidence tast 
sections that may use theme 
A sample select message would be: 
EQT ADI AD2 FSL SOH ADL AD2 aFa STXoeeETX 


XMN a No transmission number is usede 


Sana 
se 


eee eter # 
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Beer i AK EM yee OE ER I ES ed Sop ede eB peels Te Cea oe AR a IES Pe a Rat ee A A Oe See Sy tas Vogt ON a a eee ak ae : eg een ae Se a ae titi Bae ha eee teh 
ws eben ra dali he cial id ae ON Po TE Se ete tne ee oR alin ed beat CELA eNO ES TO at ne ak tt SE ae Tle SD hs a ae tt ME a eel ek cad Oe eet cel ae te re tel Sve LED ERE eee i ee aces baie Set WAK Ly cee Hn 
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LITERALS AND VALUES 


POINT 


Po meea ena cceneresse= [ CNUMBER> ] seeteee seen nn--e------ woer--->7 


DATA GROUP 
> tere n ran nner e eee ene CALPHAD cree enone en nn ene nnn e nen eee nen-- >? 


l--- <HEX NUMBER> <-->] 


ALEHA 


I< REE ewnewuas ee ee ee eee ee j 


po. NUMBER 


}- Se * ) i 
femw= <DECIMAL NUMBER> e-->1 


> ee aeawen aewee @ a su euaq = € | to 3 = oe oo we oe ee ee wew se cawewewewasenwen>FZ 


DECIMAL NUMBER 


wnahs p hbleds Abas: 


x 
. 
w 
' 
( a 
wey * 


Cees rote a 


fa Ne LEW kate Rey Ay EEE AS AP ded a latino Le Ma SE LSE ER Meg Ca ine A ER es aca Lin el RK OS i ate DE a Tk vt eel Slice a bet ad SE Pate eae wll OO alate wisi is ais a ee ee aS 
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OPERATING INSTRUCTIONS 


ENTERING COMMANDS 


BOLT is executed tike any other normal state program under 
controt of the MCP. When BOLT comes up it wiil display the 
following message on the ODTs. 


saeee ENTER NEXT COMMAND taaee 


The operator may then communicate with BOLT by using the ACCEPT 
mechanism as fotlowss 


<BOLT job number>AX <BOLT command> 


Whenever @O0LT goes to the idle state or wants operator input it 
will display the ENTER NEXT COMMAND message on the ODT. The 
operator may also enter unsolicited input at any time in order to 
stop or change a test. 


When BOLT is executed» oor the CLEAR or RESTART commands are 
entered» the display and operating options are initialized to 
their default values. The operator may change the options at any 
time and the current state of the program options may be queried 


using the DISPLAY commande 


REQUIRED FILES 


BOLT requires a minimum of two files to be present in order to be 
executed: The SOL object file named “BOLT™s» and a random disk 
input data file named "BSOLT/ERROR™. In addition the optional 
random disk input data file named "BOLT/TEACH™ should be present 
1f the TEACH command is to be usede if “BOLT/TEACH™ is n”ot 
present» BOLT may stitt be executed but the operator witt be 
informed that the file is missing when BOLT is started and every 
time the TEACH command is entered. 


i ia ale eat att 


ae 
Ze 


Joke 


f lat Beta A ate be pease gn Haste: Davgiicintn cnt 5 alain te 8 28 8 Sle nee hp ty SS : foes sn eet & 
DEER TY ble ROL A bbs euid So 2 Epes o yar soit tae South Sit BE Se es SLE Ee Ria ec ce en a AN at a eat aia bg bela ind ane ale as Seah eete aaa DO Aan Ce OC ROT 
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PREDEFINED TESTS 


To execute a predefined confidence test on an I/0 devices the 
operator would first select the desired device using the UNIT 
commande If the device is not available then the operator must 
wait for the device to become avaiiadile or test another device. 


Once the device has. been properly selected using the UNIT 


commande the operator may execute the defauit list of test 
sectionss using the default setting of the options by simply 
entering the GO command. The test will report the number of 


errors found for each section and display a message when the test 
has finished- 


If any soeveus other than the defaults are desired» then the 
operator would enter the option command{s) and then enter the G43 
commande The default section list for each test wiki consist of 
confidence test sections that do not require operator 
interventtone For i anstructions on executing optional test 
sections that perform diagnostic testing or further confidence 
testing which requires operator interventions refer to the 
SECTION command documentation. 


EXAMPLE TEST RUN- 


This section shows the BOLT commands used to run a typical test 
session on the LINE PRINTER. Also shown are 838GLT*%s cutout to the 
OOT tn response to these commands. 


First BOLT is executed» at which time it displays some 


Initialization messagese When BOLT is ready for input it wilt) 


prompt the operator for an AX message: 


EX BOLT . ye 8 
BOLT = 325 BOJ~s PP=4» MP=4 TIME = 14255204.2 


@e 00 86 66 06 


& BOLT =325 seeee ENTER NEXT COMMAND «teen 
BOLT =325 ACCEPT. : 


Next a device is selected using the UNIT command which executes 
inittaltzation code for that device and displays some greeting 
messages if the unit selected was successfully obtained: 


ee ie 


Baie OTe erate rea ae See 


4 BOLT =325 BOLT €31000 UNWLINE FESTS) VERSTONS 2.2 DATED? 017235781 
% BOLT =325 ENTER “<MX #>AX TEACH” FOR A SUMMARY OF BOLT COMMANDS. © 
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325AX UNIT LPA 

> %£ BOLT =325 

s % 30LT =325 

s Z BOLT =325 3 

3% BOLT =325 TOTAL UNITS OBTAINED = O1 

> % BOLT =325 UNIT NAME = LPA PORT = 7 CHANNEL = 3 UNIT = 0 

3 % BOLT =325 

3 2% BOLT =325 LINE PRINTER TEST #- VERSION AA 

3 % BOLT =325 | Sete em sso seas en aman esansaanes 

2: 2 BOLT =325 

=: £2 BOLT =325 DEFAULT CONFIDENCE TEST SECTIONS ARE 5 eae: 
s £ BOLT =325 OPTIGNAL CONFIDENCE TEST SECTIONS ARE 25 - 32 
>: £ BOLT =325 OPTIGNAL OLAGNOSTIC TEST SECTIGNS ARE 50 = 62 
: % BOLT =325 €50 = 53 FOR PC 5/6» 54 = 62 FOR PC 7) 

3 %£ BOLT =325 | | . 
s Z BOLT =325 FOR A DESCRIPTION OF THE LINE PRINTER TEST ENTER ®TEACH 
3 % BOLT =325 LP". ENTER "TEACH LP <SECTION“NUMBER>*” FOR THE 

: 4 BOLT =325 DESCRIPTION OF ANY TEST SECTION LISTED ABOVE. SECTIONS 
s % BOLT =325 17-38 ARE READY TO RUN. 

2% BOLT =325 «xexeee ENTER NEXT COMMAND 2 &22% 

> BOLT =325 ACCEPT. 

Once the device has been selected» the default confidence 
sections can be executed by simoly entering the GO command. A 


beginning of test message is displayed for the unit and 80J = £OJ 
messages are displayed for 2ach section which includes the device 
Mame» section number and section name. 


If an error is detected by a test sections the EQJ message i15 
followed by the number of errors detected for that section. When 
all scheduled sections have completed Ceither normally or due to 
a terminating command)» an EQJ message ts displayed for the UNIT 
atong with the total number or errors detected for ati sections 
rune B80LT then prompts the operator for the next command: 


2d any T UE Neate’ dee Rae, 2Alianl Rd Rall Site Hide Sa? LIE awe A Lanile neti Ee OO ce ail I La Atl allem ete weet Tate el ote be add 
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3 


66 60 06 66 


00 06 08 86 08 66 66 63 60 a6 00 


CO He Oe Re HR TEN PE TT WRN WN NN FP HK 2 


OLT 


25AX GO 


BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 


BOLT 


BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 


Optional 


usuaily 


325AX SECTION 


@s 6¢ o¢ o8 G8 G8 


x 


yA 
4 
rf 
vA 
B 


BOLT 
BOLT 
BOLT 
BOLT 
BOLT 


=325 
=325 
=325 
=325 
=325 
=325 
=325 
=325 


=325, 


=325 
=325 
=325 
=325 
=325 
=325 
=325 
=325 
=325 
=325 


Confidence 
the section number or range and 


hb aS an ach nag at“ adhe Sek Sree Rag! on eee T Os a El atte tt ott de Ale i hl Bie ts obs eet Nae bt rated Us etl iP AL te teh me nese Pee nile Bd ices ME yee as Lik tabs dO eta be Tg ls pete ne a batt hsb Gilg Monae Bek abt 
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BEGINNING OF TEST FOUR UNIT LPA 


LPAS BEGIN SECTION 12:3 ALPHANUMERIC RIPPLE TEST. 
LPAS END SECTION 22 ALPHANUMERTC RIPPLE TEST. 
LPA>S BEGIN SECTION 22 END ADDRESS TEST. 

LPAs END SECTION 2: END ADDRESS TEST. 

LPA: BEGIN SECTION 3: SROADSIDE TEST. 

LPAs END SECTION 3: 3ROADSTOE TEST. 

LPAs BEGIN SECTION 43 NO PAPER ADVANCE TEST. 
LPAS END SECTION 4: NO PAPER ADVANCE TEST. 
LPAs BEGIN SECTION 5: VERIFY CHANNELS TEST. 
LPAs END SECTION 33 VERIFY CHANNELS TEST. 
LPAs BEGIN SECTION 6: FASTEST PATTERN TEST. 
LPAS END SECTION O62: FASTEST PATTERN TEST. 
LPAS BEGIN SECTION 7: SINGLE SPACE WRITe TEST. 
LPA:s END SECTION 7: SINGLE SPACE WRITE TEST. 
LPAS SEGIN SECTION 8:3 DOUBLE SPACE WRITE TEST. 
LPAs EN) SECTION > DOUBLE SPACE WRITE TEST. 


END OF TEST ON UNIT LPA == 009000 ERRGRS REPORTED. 
weake ENTER NEXT COMMAND ext 


=325 ACCEPT. 


sections can be executed by selecting 
entering GQ. These sections 


tese 


reguire some type of operator interaction such as making 
the device READY or visually verifying the result: 


=325 
=325 
=325 
=325 
=325 


OLT =325 ACCEPT. 


25% GQ 

BEGINNING OF TEST FOR UNIT LPA 

LPAs BEGIN SECTION 252 CHARACTER ALIGNMENT TEST, 
PLEASE READY THE LINE PRINTER SEING TESTED. 

ENTER "GO" AFTER THE LINE PRINTER HAS BEEN MADE READY. 
keaeke ENTER NEXT COMMAND “ex | | 


At this point the operator would make the PRINTER READY and enter 


GOs 

325AX GO 
2% BOLT =325 
2% BOLT =325 
3% BOLT =325 
3: % BOLT =325 
: 2 BOLT =325 


BOLT =325 ACCEPT. 


CHARACTER ALIGNMENT PATTERN HAS BEEN WRITTEN TO PRINTER. 


.PLEASE VERIFY THAT CHARACTER ALIGNMENT [S CORRECT. 


LPA: END SECTION 253 CHARACTER ALIGNMENT TEST. 
END OF TEST ON UNIT LPA *~ 0600000 ERRORS REPORTED. 
keke te 


ENTER NEXT COMMAND sea 
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When an 
devices» 
Further 
product 
result 

displayed. 
either 
operator: 


325AX SECTION 


ee 0 


When testing is compieted for one device another 


WWMM RMR KN RK NM 


ae 66 8 8@ 68 608 Ge 86 Ge G6 68 60 86 00 


BOLT =325 ACCEPT. 


BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 


BOLT 


BOLT 
BOLT 
BOLT 
BOLT 
BOLT 
BOLT 


selected 


job by using the BYE command. 


release 


have been created: 


45 
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error occurs» BOLT informs the operator by displaying the 


section # and 
error 
specification for that 
status 


t 


S62AX BYE 


s 
. 
s 
: @ 


Whenever possibles 
terminate 


error #4 with a 


information can 


along 
usually 


brief messagee 
be found tn the BOLT 
d2viceae The of code issued» 
interpretation of the status bits are also 
at this point the section wiil 

further information from the 


and 


or request 


2560 

BEGINNING OF TEST FOR UNIT LPA 

LPAS BEGIN SECTION 2: END ADDRESS TEST. 
LPASSEC O2:2ERR# O22 = FHE SINGLE SPACE WRITE OP FAILED. 
THE OP CODE ISSUED WASs 4£0000 | 
I0 RESULT STATUS FIELOs £00080 
THE FOLLOWING STATUS BITS ARE ON: 


RS BIT 1; OPERATION COMPLETE 

RS 8IT 23: EXCEPTION 

RS BIT 3: DEVICE NOT READY 

RS BIT 173 QPERATION COMPLETE 
THE DEVICE WENT NOT READY OURING A TEST WHICH NEEDS IT 

READY. 

PLEASE MAKE THE LINE PRINTER READY. THEN ENTER THE "GO" 
xkxkkER keke 


ENTER NEXT COMMAND 


device can de 


using the UNIT command or BOLT can be brought to end of 


he 


=325 


Before going to £0J» 3O0LT wilt 


device under test along with any Backup files that 


Z BOLT =325 RESTORING PRINTER DEVICE BEF ORE IT IS RELEASED 
% BOLT 
& BOLT =325 EOJ. 


LPA RELEASED BY 80LT. 
TIME = 1523024767 


PCAP TESTING USING LOGICAL I/O COMMANDS 


In addition to running predefined tests» 


the 


ability 


require. 


of descriptors» 
that the device to be tested» 
controls be obtained by 30LT using the UNIT CONTROL command. 


SOLT gives the operator 
to build and issue individual descriptors or chains 
through the PCAP facility. Att PCAP commands 
along with its associated 


The simptest tevel of PCAP operations are caited LOGICAL commands 


which 


when entered cause a predefined op to be built in DESC [0] 
and causes the descriptor to be mee ouer ery pasvece 
ere LOGICAL. ce eon Pregaala a a : 7 


CRefer to 


6 
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For examples a tape device can be rewound with the following 
command: 

T5AXREWTND 


% BOLT =76 #keeee ENTER NEXT COMMAND weer 
SOLT =765 ACCEPT. 


Or a printer can be made to skip to the too of a page with a Forn 
Feed commands 


7 6AXFFO _ | 
%Z BOLT =76 *#eee ENTER NEXT COMMAND eaux 
BOLT =76 ACCEPT. 


LOGICAL commands can aiso be used to read and write to devices. 
The WRITE command requires tnat DATA [£60] and LENGTH £0] first ba 
specified by the operator: 


TOAXDATA CO] "THIS IS A LOGICAL PCAP EXAMPLE FOR MAG TAPE” 
& BOLT =76 w*xeee ENTER NEXT COMMAND #2 e&% 
BCLT =76 ACCEPT. | 
TOAXLENGTH €01 199 
4 BOLT =76 s*xewe ENTER NEXT COMMAND sexe 
BOLY =76 ACCEPT. 
FOAXWRITE | 
*& BOLT =76 x*eee ENTER NEXT COMMAND weet 
BOLT =76 ACCEPT. 3 


Since LOGICAL commands use DESC £0] the DISPLAY command can be 
used to Look at the RESULT of the oneratioan: 


76AXDISP DESC [9] | 

% BOLT =76 a DESCRIPTOR O 

% SOLT =76 | owes enre=--- 

% BOLT =76 

% BOLT =76 OP: 400001 ALFIELD: OO9E7F RESULT: 800080 
% BOLT =76 LINK: =0000001 BS FIELD: OOA19F XRSLT1L: 00000000 
% BOLT =76 PRT/CH: 7C0=—sdC_LFIELD? 000000 XRSLT2:s 00000990 
% BOLY =76 | | | LENGTH: 000064 (000100) 

2 BOLT =76 ne oe | | 

% BOLT =76 «xaee ENTER NEXT COMMAND see 

» BOLT =76 ACCEPT. - | : 


LOGICAL commands are quick and easy to use since they do not 


require the operator to know the bit patterns for commonty used 
OD Se However» LOGICAL ops are Limited tn that they may not be 
linked together and the variant bits may not be specified by the 
operator. If more flexibility is desired» the operator should 


use the PHYSICAL PCAP commands described below. Keep in mind 
that LOGICAL PCAP commands wilt atways overwrite any PHYSICAL 
PCAP information that has been stored in DESC [01]. | . 


re eee Wag titite tes y gat Gaetiylas See o, byes B08 eet Spr Cir Wa Aehs bianiet thant, Spode Gok ete co tsh Shen aN ala ni Ee oe neg CRE Ce en men OM ee Teer a BSS. cay Raich, se Saati oy sabia pa ce dh bail Pee Se ee oe a a EP 3 eras = 
CL On Gt sat raha ee Sane SRE RN ae aghi eS cg kee DT ee Se a Rp eae ge Te POE g. he ACD © Ves MPa as ee ie pat vag) + wo ge mp Ry ee Oh UE Pe a Pt re Bt! gta tae fee Ta a eng + + th a Sipe vaca high tbs of Os ; 
Jeicd Steck chee RSE hw Ga OMI cao Sareea tnowe Loe ad al, Sertho seas Wonca PROUT prcee ia ee ee eet PT tage gg Pega eeu tee lag ee eos ane ae oa Se al ade lt Met So at ber ee Ne Nett hanna banc nned! b wer tnune gatas EUAN ab Leen Sawin docs ah wee hee ie ease Se ata? sl ing ak SA FF a ne OOK 


Sg Ties aoa me ey oS ae rote 


re hase Cite See eee TOS See wey bg State Rae bias qpereeht 4, ae te ee ae eins gut Jotake + . opens e ey Mh git tk Me Shes, “Ghee eye cwie Belen ku ed Ag Sete aps FF ict ee a ae gt aah ie ag ee a ae eee ee ie rae 
ids ven iad ‘ A OP Sk a te ee ao yak Se ae *yeee Vs fae xf! * ce Herd penarricse ad “34 os ROE ERY Uore,) ~ ia tthe ey te a! a nr ee) . cas 7 ae a “ety BS fe Oe ae - ee ayy * 5 uae oan eye eS . oh wT OP AR 2. Paes, yoede: pies veer tee "ly Rt ge ee .. ae es arent ste Ce ey er Sr tty “ee Rae raem oO 
er elee recta ad Map nde a it tel easel, AS ett a eed” SES ERE es Cae a tt LSet at EL atl ace ee oh te ae halls Lae LN tai tbe lie die CLs Leticia ace ae Lab ada taal i dd” baa ge wa ar slip haw Pb eon we ORS Borat Dace RGN aed aed tales cee eat Salle el a eS ete NS a Pat lon af eta ea” 
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| < e PCAP TESTING USING PHYSICAL I/O COMMANDS 


The operator may also perform a custom test on the selected 


peripheral device by using the PHYSICAL PCAP facility 
: The operator must first select the device and its enti 
by using the CONTROL modifier of the UNIT command. 


device and controt have been reserveds the onerator ouiids 


of 


3OLT. 


re control 


Oncaea 


descriptors using PHYSICAL PCAP commands such as OPs DATA» 
LINK and then dispatches them using the SEND command. 


operator may build from 1 to 6 descriptors» each with 
data buffer. The descriptors may be built» 11 


its 
nkeds» 


the 
1/9 
and 
The 
own 
and 


dispatched in any order. The current value of a2 descriptor field 


DESC and DISPLAY DATA commands. It is with these commands 
the operator views descriptors which are being constructed and 


commande 


and Linked together: 


C) 7ZSAXGP (1) @400000920P £2] 3DN800090950P £3] @ZOCddOdas, 
% BOLT =76 sxkaee ENTER NEXT CONMAND sea 
BOLT =76 ACCEPT. | 

7EAXLINK £13 £2] £31335 © | 3 
% BOLT =75 w#eeeexe ENTER NEXT COMMAN ak te & 
SOLT =76 ACCEPT. 

7ZOAXDATA [11] *"TFHIS IS A PCAP EXAHPLE *” 

% BOLT =76 x*eeex ENTER NEXT COMMAND «eae 
BOLT =76 ACCEPT. : | . 

ZOAXLENGTH €1] 44-LENGTH [£3] 44 ~ 
% BOLT =76 w«*xeee ENTER NEXT COMMAND w«2xe2% 
BOLT =76 ACCEPT. 

76AXDATA [31 7 * _ | 
% BOLT =76 *xxeee ENTER NEXT COMMAND sxe 


The descriptors and..the data may then be verified 
display commands , 


TN 
2 


those which have been issued. The dist of linked 
descriptors may be continuously sent out by using the REPEAT 


and its data buffer may: be viewed at any time using the DISPLAY 
that 


PC AP 


For example» assum2 that the operator has selected a tape device 
using the command UNIT CONTROL MTA» and wishes to write a record, 
read it Dack and compare the data. First the necessary 
Dackspace and read op would be built in PCAP descriptor 1 thru 3 


writes 


1 etn te tr Nm A Ne On rN hte Sd cet ESS BIRD a bead ne RN I nad Sila le Le lar adic he hte a ds Nee DI Ra a a ae El alee AD Ne Sw cle a TAD Se ae ent aig GS ee tee rhe etd ean ode ae Cad pane ete Stadia sa oe Bt a 
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LU 76AXDISPLAY DESC [1] 
% SQLT =76 DESCRIPTOR 1 
% BOLT =76 <<< SS == s </> 
% 30LT =76 
& BOLT =70 £OPs 400001 AFIELD: d003E7F RESULT $ 9000690 
% BOLT =70o0 LINK: 90002 SO FYELO:s OOS3FDF XRSLT1L: ¢C020900000 
2 BOLT =76 PRT/CH: yi C_FIELD: 000000 XRSLT25 00000009 
% SOLT =76 LENGTHS: 90002C (006044) 
% BOLT =76 
% BOLT =76 x*x*ee ENTER NEXT COMMAND seeex 
Y6AXDISP DATA £1] 
2 BOLT =76 DATA (137 CONTAINS THE FOLLOWING DATA 
~% BOLT =76 
Z BOLT =76 EXC8CIEZ4OCSEZ4OCLT4A9ND7ECSCID740CSE7CIDADTOSCS40ESC8C IE? 
Z SOLT =76 40C9E240C140D7C3CiD740CSE7CID4AD7 D3 
% BOLT =76 
Z BOLT =76 THIS IS A PCAP EXAMPLE THIS IS A PCAP EXAMPLE 
Notice that BOLT orovides the unit number in the Last four bits 
of the op field. The result status fietd is cleared before any 
of the descriptors are issued. 
The first descriptor in the chain is dispatched with the SEND 
command and the read and write buffers are checked against each 
aa other with the COMPARE command: 
C) 


YZOAXSEND C13 
* BOLT =75 *x«x«x 
BOLT =76 ACCEPT. 
ZOAXCOMPAKE C1] £3] 
* BOLT =70 COMPARE OF SUFFER 1 TO BUFFER 3 WAS SUCCESSFUL 
% BULT =76 *xx*e2 ENTER NEXT COMMAND kak & & 


ENTER NEXT COMMAND *xwxee% 


Each of the deeceineere can be displayed and the RESULT fietd 
examined to verify that the ons completed as expected: 


76OAXDISP DESC £1] 


% BOLT =76 DESCRIPTOR 1 
% BOLT =76 — (| seneceeeeers 
% S0LT =76 | “ ee | | 

 & BOLT =76 OP .. 400001 A_FIELDs OOBE7F RESULT: 800080 
2 BOLT =76 LINK: 00C002 8B_FIELD OO8F DF XRSLTL: 00000000 
% BOLT =765 PRIT/CHs TO C_FIELD 0000909 XRSLT2: 00000009 
% BOLT =76 | LENGTH: 90002C (000044) 
*» BOLT =76 
2 BOLT =76 ee. ENTER nee COMMAND kk kik 

To demonst raise: Ghat: Wood one: 1f #=a data miscompare was 


- encountered on the read operations one tetter in DATA [31 will be 
—.., Changed and the two buffers wiit be compared again: | 


cet ee er eg ot 
Tat teat apt bitan dence vibe OA ng tre Bettie ten ie 


te ERA pe hae de be I RT kr ee ans Sate TNT ee yt eg ee OR MS te Prey a RN ye A eT eR ates gt ey a 
| BP cee are he EO arte a at ae ia ie ROR baba nd peleteel! Lie wcliee welts Cae LY Ue ed ond bis tebe Meena acetal a ee a Be ls es Cote Lo ae CE eet 
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ad 
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TOAXDATA ©3131 "THIS 5 A PHAP EXAMPLE” 

A30LT =75 *#eeee ENTER NEXT COMMAND twee 

BOLT =76 ACCEPT. 
TOAXCGMPARE C1] C3] 
BOLT =76 MISCOMPARE SETWEEN EXPECTED AND OSSERVED DATA. 
BOLT =765 DATA COMPARISON ERROR = FIRST ERROR DETECTED AT 
BOLT =76 HEX 00023 
SOLT =760 MAX OF 46 CHARACTERS ARE OITSPLAYED STARTING AT 
BOLT =76 THE iST DETECTED ERROR. 
> £2 BOLT =76 
BOLT =76 EXPECTEDCOOOLIISHAP EXAMPLE THIS IS A PHAP EXAMPL 


Sar RE TZN 


4 


¢ 


SOLT =76 TOTAL NUMBER OF 4=-31TS IN ERROR» 00002 
BOLT =75 COMPARE OF BUFFER 1 TO BUFFER 3 WAS NOT SUCCESSFUL 
BOLT =76 a**xeex ENTER NEXT COMMAND eee 


CONTROLS AND DEVICE TYPES 


To better understand the steps involved in running an OnLine 
test routine» consider the following example. Assume that an 
operators running BOLT from an ODT» wishes to run the Default 
Confidence Confidence Test Sections on two different devices (MTA 
and LPA for example). After the completion of both tests the 
operator wants to bring BOLT to ENDw“OF7U08 CEOS). See FIGURE 1 
below. 


x 

% BOLT =76 OBSERVED CAP EXAMPLE THIS IS A PCAP EXAMPL 

% BOLT =76 ERROR(S) $s ‘ 

2 BOLT =76 

% BOLT =76 ; | 

% BOLT =75 EXPECTEDC00022):CBC1D7 4OCSEY C1D4D7 D3C540 E3C8C9 E240C9 
% BOLT =75 OBSERVED 2C3C1D7 40CSE7 CiD4D7 D3C540 E3C8C9 E240C9 
% BOLT =76 ERROR(S) $8 

% BOLT =76 | : 

% BOLT =76 EXPECTED(C00058)3E240C1 4007C8 C1D740 CSE7C1 040703 C5 

% BOLT =76 OSSERVED 2E240C1 40D7C3 C10740 CSE7C1 040703 C35 

% BZOLT =76 ERRORCS) : t 

% B0LT =76 | 

% 

x 

z 
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, 
GPERATOR INPUT $ oy RESPONSE 
wsaewaeanmenoease we aoe jor Rae an nna e Sea waa nnanmaeanaanas 2 2 @ aeqauaaan w= anaouwen = maa wm 
UNIT MTA l es that the specified unit 1s valid. 
1 Perform a diagnostic OPEN on the MTA unite 
j If successful OPEN then access 15 granted» 
i and Default Section numbers are toaded. 
i If unsuccessful OPEN then an error message 
i is displayed and UNIT MTA has no effect. 
1 
GO i Cait the TEST_UNIT proceduree Do ail test 
i sections specified and return control. 
i TEST_LUNIT cails MAGNETIC_TAPE_TEST with 
i the section number to be executed. 


i 
tke Magnetic Tape Test Finished «x*x*x** 
j 
UNIT LPA i Verify tnat the specified unit is valid. 
i Perform a diagnostic CLOSE on unit MTA» 
j which releases it back to MCP controte 
i Lf successful CLOSE then attempt OPEN LPA. 
| If unsuccessful CLOSE then an error message 
J 1s displayed and UNIT LPA has no effect. 
1 Perform a diagnostic OPEN on the LPA unite 
} If successful OPEN then access is granted» 
4 and Default Section numoers are toaded. 
}) 06 f unsuccessful OPEN then an error message 
{ $s displayed and UNIT LPA has no effect. 
i 
GO i Cati the TEST_UNIT procedure. Do ali test 
1 sections specified and return control. 
i TESTLUNIT catts LINE_PRINTER_TEST with 
| the section number to be executed. 
i 
kkkkk kk cana Praneer fread Finished *teta%* 
BYE Perform a diagnostic CLOSE on LPA unite 
[f successful CLOSE then bring SOLT to EOJ. 


j 
{ 
i : 
4s°)6ocTf « unsuccessful CLOSE then an error message 
' “is displayed and the BYE has no effect 
j | ST | | 


FIGURE 1 - GAINING ACCESS TO DEVICES AND RUNNING TESTS. This 
figure shows the steps involved in gaining access to a device 
when the UNIT command 3s entered. Also shown ts the minimum 
operator input required to run Default COntidence Test Sections 
for a device which has theme | 
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PROGRAM SWITCHES 


For debugging and tracing purooses the software program switches 
for 3O0LT have been assianed as follows: 


SW 0 7 30LT Executive Creserved) 
SW tt * SOLT Executive CTTY macro) 
SW 2° BOLT Executive (000 macro) 
SW 3 * BSOLT Executive (reserved) 
SW 4 = BOLT Executive Creserved) 
Likewise» program switches five €5) througn nine (7) have been 


assigned to the On-Line Test Routines as foilows: 


SW 5 * Trace Procedure Entries and Exits 
SW¥ 6 * Debug Output Such As: 
“= Procedure Parameters 
“-- Important Variables 
“= Procedur2 and Function Results 
SH 7 = QnwLine Test Routine Creserved) 
SH 2&2 =~ OnwLine Test Routine Cresarved) 
9 - OnwLine Test Routine Creserved) 


Et All cther program switches are either used internally or are nor 

| used by the B8OLT Executive and/or On-Line Test Routiness Ta 

| elther casep those program switches should never be enabled when 
executing S3CLT. 


DYNAMIC MEMORY ALLOCATION 


Tne default allocated dynamic core for BOLT is 1024 bytes (3192 
bits). This area is used as 3 buffer for Magnetic Tape 
operations (C€Read» Write & Erase); howevers the operator can 
increase the size of the buffer using the MCP MO command. 


Example: MOQ BOLT ME 16384 Sets the buffer size to 2048 
te a Dy tese 
| | | | 

The maximum dynamic memory that can be aitocated for an SDL 
program such as BOLT is &S&K-1 bytes €4095 bytes or 32760 bits). 
When BOLT is executed it wiil check its dynamic memory» display 
an error message and go to End of Job if it is less than 1024 
bytes or greater than 4995 bytes. [t should be mentioned that 
the LENGTH command can be used to adjust the tength of the 
Duffer.s * Pore. 4 #0? (ba ow. al & a | 
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ODT TRACE 


BOLT*®s QDT output messages ara designed to work with ODTs or 
remote terminals with ODT capabitities. The messages are 
designed to scroll from the dottom of the screen to the too. 
Since the default mode of the OD9T 21s to Scroll from top to 
bottom» the BOLT messages will appear in reverse order on the 
screene This can be corrected by entering the MCP command Ka 
DIRN 1 which alters the ODOT default mode and causes the wmessages 
to scrotlk from dottom to tope fo return the ODT to default moda» 
enter «8 DIRN O. 


Sometimes it is desirable to have a permanent record of the 
commands entered to B80LT through the ODT as well as SOLT*s 
responses to the 30T. This can de done by making the printer NOT 
READY and entering the MCP command “B LP ON. This wilt creste a 
printer oackup file caited "SYSTEM.ODT/OUTPUT™ which witl be a 


trace of all ODOT activity. When ait the desired information has 
been recorded the operator may enter A€8 LP OFF and P3 
SYSTEM-GDT/OUTPUT. 
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PROGRAM STRUCTURE 


The 80LT executive and test procedures are co#pited as a single 
SDL programe Eacn test 38s written as one Large procedure that is 
insertad into the executive. The entire executives including the 
test procedurass 1s BOLT/SOURCE. The organization of this file 
is shown in FIGURE 2. 


When BOLT/SQURCE is compiled» it generates the listing file 


BOLT/LIST and the object file BOLT/98J. In ecrder to executa 
SOLT/IBJ» the two data fites 30LT/TEACH and 3OLT/ERROR are 
required. These files contain the teach and error messages» 


respectivelys» for 8OLT. 


a 
C) 
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FIGURE 2 - BOLT STRUCTURE. 
tn the order shown above. 
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The source code for BOLT is arranged 
The test procedure for each device is 


inserted oetween the command procedures and the intializatian 


 codee 


— 
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COMMENTS 


The CUMMENTS section contains alt documentation that anopears at 
the front of the orogram such as cooyright and release 
informations. 


GLOBALS 

The GLOSALS section contéins the global defines and deciares (for 
BOLT. Defined as constants are such values as array lLenathss 
valid unit mnemonics» giegnostic I/0 constants» and the Limit and 
default values for parameter aptions. Error message names are 
atso declared as sequential numoers for indexing tnto the error 
file. The error display and diagnostic I/0 routines that are 


called by the test sections ar2 also Located in this file. 


UTILITIES 


The UTILITIES section contains utility orocedures for the 
executive such as SCAN» FILL 3UF» COMPARE _SUFF, GET_LINDEX» atc. 
Procedures that are common among test routines are also found 


heree 


COMMANDS 


The COMMANDS section contains the procedures that are called dy 
INPUT_CONTRSOL to process a command that has been entered by thea 
operator at the ODT. 


TESTS 


Each type of I[/70 device wilt have a separate test that is written 
as a BOLT procedure.z The procedure consists of a cas2 statement 
which dees a cali to a subwprocedure for each section of the 
teste. The executive determines the section number to execute and 
passes the number to the test procedure. When the selected test 
section has completes control is returned tao the executive. The 
test procedure sections interface ta the executive by using 
giobal procedures and. global vartables that are maintained by the 
executive. © | 
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INITIALIZE 


The INIT section contains the MAIN procedure» the INPUT_CONTROL 
procedures and the TEST_UNIT procedure. The MAIN code 
initializes arrays and variables and sets up in an infinite tooo 
that sets the current section index to zero and caliis INPUT 
CONTROL.» INPUT CONTROL disolays a message to the operator asking 
for the next commands and then waits for the operator to enter 
inpute The OOT input is scanned and a case statement is executed 
to Implement a call to the appropriate orocedure to orocess the 
entered commande The program will rematn in INPUT_CONTROL until 
aaQ command 1s detected at which time 4t caits YEST_UNIT. 
TEST_UNIT determines what procedure to catl for the selected unit 
and serves as a universal section driver for all tests. 


INTERNAL FILES TQ BOLT 


In addition to the files mentioned above» S80LT also has five (5) 
internal files with which 1t works. Two of these fiies are used 
for input messages» two for output messages» and the last for 
diaqnostic purposese Each file is briefly explained below in the 
order just givene © | 


TFILE 


The file known internally to BOLT as TFILE is a random access 
disk input data file which contains the information necessary for 
the TEACH commands» BOLT wiits» by default» took for an externat 
file named B0LT/TEACH unless the MCP MODIFY command is used to 
change the default file name. The TFILE is cptitonal and if not 
found» BOLT will inform the operator that the TEACH command 
cannot De used and continue one To understand how the TFILE is 
structured, consider the following example. You wish to.learn 


about the BYE command» so you enter and transmit to 3B0LT the 


command “TEACH BYE".  $B8O0LT reads a single header record from the 
TFILE which describes the information to be disptayed. This 
record is at a predefined record tocation and would took 


something Likes 


BYE 350 12 — 


where the word "BYE" is only a comment for maintenance ourposese. 
The "350" says that the information to be displayed begins at the 
350th record in the files and the "12" says that there are 12 
records of information. BOLT then displays the 12 designated 


- tines from the TFILE. | 
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EF ILE 


The file known internally to SOLT as EFILE is a random access 
disk inout data file which contains ali the error and informaticn 
messages used by the program. FEvery message required must have a 
predefined anemontc which is equated to the record position in 
the EFILE of the desired messages. When an error 1s detected or 
a message is to be displayed the appropriate record is read fron 
the EFILE and displayed Cdependent on BOLT display option 
settings). By defautt» BOLT witl took for an external file named 
BOLT/ERROR unless modified using the MCP MODIFY command. The 
actual structure of the EFILE is exptained with an example in thea 
section of this document named "ERROR MESSAGE FILE. | 


PFILE 

The file known internatly to BOLT as PFILE 1s an output message 
file. This file is not produced uniess the PRINTER ontion is 
turned one Tf the PRINTER option 1s turned on and there is a 
printer avatlable»s the information will ge directly to that 
printer.e If there is no printer avattabie» a BACKUP.PRT fite 


a a wilt be madee Information written to the PFILE will contain the, 
& following: _ 


ie BOLT commands entered by the operator. 


2. ALL information displayed by 89LT to the ODT» except the 


Waekex ENTER NEXT COMMAND ***8e™ message. Note PpFILe 
information may be more detailed than that displayed to the 
ODT. | | 


3e Alt of the TFILE information and EFILE messagese 


OF ILE 


The file known internally to SOLT as DFILE is an output message 
file. This file will contain ail debug and trace information for 
the SOLT Executive and OnwLine Test Routines» shouid the proper 
program switch(es) be set during execution {see section oan 

PROGRAM SWITCHES). = The fite produced witt be a BACKUP.PRT file 
unless changed using the MCP MODIFY command. In normal use» 
program switches should not be set and this file» therefore» 
should not be producede a | 


you, . -OOURIE ee a ee ee ae 
bial The internal file known to BOLT as ODIOFILE is used for diagnostic = 
.. .: 10 purposes COPEN» CLOSE» 10)» and should be of no concern to  — . 
ao | BOLT users and programmers. — et ee i, A 
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INTERFACING A TEST ROUTINE TO BOLT 


This section explains how an On-Line test routine interfaces toa 
GOLT » tha required names of test routines» and how a test 
routine’s initial statement should be structured. 


ABQUT ON“LINE TEST ROUTINES 


As explained earliers the OnLine test routines are written 
separately by the oproagrammer and then included into the BOLT 
source for compilation and execution by means of the SDL LIBRARY 
option. BOLTs at presents» is capable of testing severat devices. 
Device or unit tests are written as one procedure with each test 
section o81ng a separates» nested orocedure within the test itself 
(see FIGURE 3). The devices which BOLT is capable of testing and 
the required test procedure names are Listed betow: 


1. Magnetic Tape oes MAGNETIC_TAPE_TEST™ 
22 Card Reader “- CARD_READER_TEST 
a 36 Line Printer “= LINE_PRINTER_TEST 
C) | 4. MultiLine Control = ** MULTILINE_TEST 


Exactly how devices are selected for testing by B8O0LT» and how tha 
aboved named procedures are caited is explained in the following 
sectionse | 
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FIGURE 3 - INTERFACING A TEST ROUTINE TO BOLT.j The above diagram 
illustrates the Top-Down structurs of BOLT and tndicates how the 
test sections interface to various parts of the executive. ALL 
of the nodes in the diagram» except the "ERROR INTERFACE 
ROUTINES* nodes correspond to a single procedure» though that 
procedure may consist of many nested sub-procedures Ceede 
LINELPRINTER_LTEST). 2 2 2 oe ee oe _. & ° 
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CALLING TEST ROUTINES FROM BOLT 


The purpose of this section is to exptain how the BOLT Executive 
goes about calling a test routine. The GO command telis BOLT to 
Start Cor continue) a given teste If a valid unit has been 
selected using the UNIT command then the GO command is accepted. 
BOLT then catls the test controlling procedure TEST_UNIT. 


TEST_UNIT 


The TEST_UNIT procedure is the controtling Cdriving) Loop for ail 
test routines. At its disposal ts a list of test sections to be 


performed (Cresult of the SECTION or UNIT command). TEST_UNIT 


essentially goes down the List» calling the appropriate test 
procedure with the current section number Cobtained from the 
list) to be rune The test saction returns a return code (see 
FIGURE 3) indicating the result of the task just performed. The 
control Loop of TEST_UNIT determines the aporopriate action to be 
taken. Return codes and the actions they cause are Listed belou: 


RC_CONTINUE “- normat or error free result. Go on 

| | tt the next test section selected. 

RC_LOCK , ©" begin the current test section over 
| _ again. 


RC_TOO_MANY_ERRORS == too many errors detected for the 
test €see MAXIMUM command). Stop 

| 3 a. the test and go to an idte state. 
RCL INPUT_PRESENT | “= jnput entered while the test was 
| 5 running has caused the test to be 
stoppede (CLEARSRESTARTsS EXIT »>UNIT). 


RC_ABORT_TEST | “= the test routine has detected some 
. a abnormal condition so the test 15 
abortede 


RC_ABORT_SECTION “- the test secton has detected some 
oe | a = cabnormat condition so it is aborted 
~. ‘The mext section witit be executed. 


The return codes are futher explained in various other sections. 


At present» we have seen how to run a series of test sectionss 
how BOLT goes about gaining access to a device and calling the 


right test routines» and how the test control toop works. Next 


we look at the structure of a test routinee 
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TEST ROUTINE STRUCTURE 


The structure of an OnwLine test routine is quite simple. Every 
test will be a single procedure» whose name has already been 
| determined Csee ABOUT OGON"LINE TEST ROUTINES). This procedure 
| - wiil have one parameter» it being the number of the test section 

to be executed. Test sections are nested procedures within the 

test routines» the first such procedure being test section 41. 
| The main statement of the test routine is a CASE statement» 


indexed aff of the parameter passed to ite FIGURE 3 shows a 
stripped down modet of what the LINE_PRINTER_TEST might took 
like. - 


To see how an actual test sections might be written (i.e. how to 
handie error conditions» operator inputs e- etc) see the section 
entitled TEST ROUTINE EXAMPLE. 
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PROCECURE LINE_PRINTER_TEST CSECTION_NUMBER) FIXED> 


FORMAL | 
CURR_SECTION_MUMBER FIXED> 


put allt test record defines here 


NWN NN 


put all UTILITY ROUTINES here 


put all test constant defines here 


put all test vartabla dectaraticons here 


PROCEDURE INIT_RESTORE_TEST CINIT_RESTORE_FLAG) FIXED; 
Z initialize or restore test if necessary 


END INITLRESTORE_TEST> 


PROCEDURE ALPHANUNERIC_RIPPLE_TEST> 


£ this is section #1 
ENO ALPHANUMERIC_RIPPLE_TEST> 


66 


PROCEDURE END_ADDRESS_TESTS 
£ this is section #n © 
END END_ADDRESS_TESTS 
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CASE CCURR_SECTION_NUM); 4 LP-TEST 


tnitial statement 


RETURN INITLRESTORE_TEST CINIT_LRESTORE_FLAG)> 


RETURN ALPHANUMERIC RIPPLE_TEST s 


| _ RETURN ENDL ADORE SS_ TEST> 


END CASES a 
END LINE_PRINTER_ TESTS 


%Z section it 
Z section 2 


% section n 


FIGURE 4 - TEST ROUTINE STRUCTURE. This figure shows the general 
Structure of a test procedure. For a detailed exampte of a test 
routine see the section entitled "TEST ROUTINE EXAMPLE”. 
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DEF INES 


The foitlowing identifiers have been DEFINED tin the SOLT executive 
and may be used by the test sections: 


IDENTIFIER 


TRUE 
FALSE 


SUCCESS 
FAILURE 


BOOLEAN 


CH 


CONV 


BLANK_LINE 


“INITIALIZE 


RESTORE 


VALUE 


SITC1) 


CHARACTER 
“BITCS) 
‘DECIMAL 


CONVERT 


 gndicating that the device 
pestoreade 


DESCRIPTION 


Boolean literal having the value one. 
Boolean literai having the value zero. 


that a 
without error. 


Equivatent to TRUE.j Indicates 
routine has completed 


Equivatent to FALSE. Indicates that a 
routine has completed with an error. 


Define for declaring boolean variables 


Abbreviatione Used to declare charact=- 


_ @Ff vartables or display conversions. 


Literal for dectaring byte variables. 


Abbreviations. Used when converting a 


wvwariable to decimal formate 


Apbreviation. Used when converting 
variables to different types. 


Can be used to display a blank Line if 


necessary. 


Passed to INIT_RESTORE_TEST routine 


indicating that the test routine and 


and device should be initialized. 


Passed to INIT_RESTORE_TEST routine 
should be 
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—_ 


The following defines are used by the test section orocedures and 
the test routine driver to indicate what acticn is to be taken. 
The value of the define is specified in the parentheses. | 


RC_CONTINUE (C0) 


Error Interface routines return this code to indicate that the 


test section is to continue. When an 1/0 or error check 15 
issued and it completes successfuily this return code will 
resuite This code witi aiso be returned 1f the I/0 or error 


check completes with an exception or error condition and current 
error option Serkangs indicate that the test section 1s to 
continue. 


This return code is also returned to the test section driving 
loop should a test section complete normaliy. 


RC_LOCK €1) 


At the end of every 1/9 or error cheacks the test section wili 
determine if the operator has selected this “lock position™ to be 
Locked on (see LOCK command). If so then the RC_LOCK return code 
1s returned to the test section driver. The current test section 
wilt be execured agains 7 | | 7 


. 
Sarr 


ie ee Shue comes @) 


When an error occurs» one of the error interface routines is 
called to report the error and determine the action tc be taken 
depending on the current error option settingse As errors occurs 


they are counted. ff the ERROR_COUNT reaches the maximum error. 
counts as set by the MAXIMUM command» then this return code is 
returned» indicating that too many errors have been detected 


while running the current teste The test sections seeing this 
return codes will pass it atoang to the test routine drivers which 
will in. turn terminate ne test. 
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RC_INPUT_PRESENT (3) 


In order to be sensitive to unsolicited input from the operators 
test sections must calt the CHECK_FOR_INPUT procedure before eacn 


I/Q or error checke If input ts found» the test section is 
brought to an idle state» the input is parsed» and the 
appropriate action 1s taken. The test section will continue 


again when the GO command is entered. If» however» the operator 
Should enter the RESTART» CLEAR» EXIT» or UNIT command then this 
return code witit result» indicating to the test routine driver 
that the test is to be terminated. 


This code is ablso returned by the CHECK_HALT_AFTER_IO0 routina 
should one of the specified commands be entered while a test 
section is tn the idle state after an 1/0 aperation (Csee HALT 
command). | 


RC_ABORT_TEST C4) 


This code is returned when the test routine determines an 
abnormal condition for which the entire test should be aborted. 


RC_ABORT_SECTION (5) 


This code is returned when a test section determines an abdnormat 
condition for which the immediate test section should be aborted. 
Execution wiil continue with the next scheduled section. (see 
SECTIGN and UNIT command). 


The following codes are returned whenever the diagnostic [70 
interface is called by a tast section. In normal cases» test 
sections would expect the I[0_SUCCESS return code. This is not 


trues howevers when an {/0 is issued expecting failure. Test 


sections check these 1/0 return codes to determine the 
appropriate action to be takene | 


IO_SUCCESS (0) 


‘Indicates that an 1/0 descriptor completed without exception. 


10 -FAILURE ca) 


Indicates ‘that the 1/0 was not eee because there was an error 


in the format of ote communicate. 
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IOLEXCEPTION (2) 


Indicates that an 1/30 comoleted with an exception. 


IO_MAX_RETRY (3) 


Indicates that an I/0 descriptor continued to nave an exception 
after being retried the number of times given by the RETRY 
option. 


‘IO_TIMEQUT (4) 


Indicates that an I/0 descriptor timed out. S80LT assumes at this 
point that the deavice 1s hunge 
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emt 


GLOBAL VARIABLES 


Betow is a List of variables declared oy the 30LT executive which 
may be used dy the test sections. Given is the variable name as 
Tt appears tn BOLT,» the variable typesr and a brief descrinotioan of 
how the variable can be used. 


LOCK _ POSITION TYPE: FIXED 


This variaole is used tn inptementing the LOCK command. Ic 
uniquely identifies major test section components such as a 
single ID» a lLocp around an [0% a data cogpares eee 2tce This 
variable must be set to one (1) at the beginning of each test 
section (Cprior to the first major comoonent)» and is Dumped by 
one (1) oefore each successive test section component. Further 
details can be obdtained from the discussion of Utility Routines 
and from the test routine example at the end of this document. 


POSITION_LOCKED_ON TYPEs FIXED 

a, | 

This vartable is used in inplementing the LOCK command. If the 
LOCK option has been set on and an error occurs then this 
variable is set to the current LOCK_POSITION. At the end of each 
major test section component this variable must be checked to see 
if it 1s equal to the current LOCK_POSITION. If so then the 
return code RC_LOCK is returned to the test routine driver. (see 
RC_LOCKs LOCK commands and the test routine example. 


{ 
A 


ERROR_CODE a TYPE: FIXED 


This variable is set by the CHECK_ERROR_OPTIONS routine when one 
of the error interface routines is called.sj Its value wili be one 
of the RC type return codes» indicating what actton the test 
section should takee | 


ERROR_COUNT TYPE: FIXED 


Meaningful only when test sections are currently runninge Teiis 
how many errors have occurred durint the current test. This 


value is displayed when the DISPLAY command is tssued. 
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BEGIN_ERROR_COUNT TYPEs FIXED 

Meaningful ently when test sections are currently running. Tatts 


how many errors have occurr2d during tne currant test section. 


Tnis value is reset before the axecution of each test section anda 


is displayed at the end of each. 


DEVICES_IN_USE TYPE: BOOLEAN 


Indicates that a device has odeen successfully selected § (for 
testing Csee the UNIT command). This variabie wilt always oe 
TRUE when viewed by a test routine. 


CONTROL_SELECTED  ~ TYPE: BOOLEAN 


Counterpart to DEVICES_IN_USE. Indicates that doth a unit and 3 
control have been selected for testing Csea the UNIT command). 
In such a cases doth variadles will be TRUE. 


TEST_DESC | TYPES DIQ_DESCRIPTOR 


The I0 descriptor used for att 10 requests through the [9 
Interface Routines. Any test using the interface routines for an 
IO wilt find the resulting descriptor information heree See the 
section named "10 DESCRIPTOR FORMAT" for the detaits of an 13 
descriptor formate This descriptor may be viewed by the operator 
at any time by issuing the OISP DESC commands Without a 
descriptor index. ' | 7 


TEST_LEXT_RSLT | TYPES BIT €64) 


All IQ descriptors are issued atong with a request for an 
extended resuit descriptor» thceugh the unit may not provide one. 


In such a case» this field wiil be zero. If the unit does. 
provide an extended result then this field wiil contain that 


result if it was orovided on the tast I90 issued through the 18 
interface routines. 
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TEST_DATA TYPE: ©1024) BYTE 


Just as the 19 descriptor and 
by BOLT» sc is tnis data buffe 
of using this buffer for MT 
buffer. 


extended result field ara provided 
fs Test routines have the aptian 
ad data or dafining their own data 


taux DYNAMIC MEMORY ALLOCATION x2%%* 


EXCEPTION _F OUND TYPES BOOLEAN 


This bvoolean indicates whether or not an exception occurred = on 
the last sequence of [03 descriptors issued Ciee. PCAP mode 
descriptors as weil as TEST_DESC). 


CURRENT_PORT_CHANNEL TYPES BIT (7) 


The PORT and CHANNEL of the unit Sy BOLT to oe tested. Only 
valid if the variabte DEVICES_IN_USE 15 TRUE. This informaticn 
is automatically inserted into the 10 descrintor cefore it 15s 
issued to the selected device. 


CURRENT_UNIT_NUMBER «TYPES «BIT (4) 

The UNIT NUMBER of the unit that is currently selected dy BOLT to 
be tested. CThe units® port and channel are found in the 
CURRENT_PORT_CRANNEL Variable). This information 1s 


automaticaily inserted into the [3 descriptor OP_CODE field just 
before the [0 descriptor is issued. 


USE_DEFAULT_DATA «TYPES BOOLEAN 


The operator may specify the data to be used in scme test 
sections» overriding the default data. This flag is set to TRUE 
if the default data» rather than operator entered data» is to be 
used for the test section. 2. *. | 
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USE_DEFAULT_LENGTH TYPE: B800LEAN 


The operator may specify tne data length to be used In some test 
sections» overriding the defauit tengtn. This flag is set to 
TRUE if the default Lengths» ratner than operator entered lengthe 
is to oe used for the test section. 


USE_DEFAULT_RECORDS TYPEs BOOLEAN 

The operator may specify the number of records to be used in soma 
test sections» overriding the default records. This flag is set 
to TRUE if the default records» rather than operator entered 
records» are to bea used for the test sections 

RETRY_OVERRIDE TYPEs BOGLEAN 

This boolean may de sat to TRUE by test sectians to override the 
retry capaoiltities of the Ganeral Diagnostic IG Routine CDO_If0)» 
giving the test section comolete control over the retry facility. 


INIT _RESTORE_F LAG TYPE: SOO0LEAN 


When a unit is succussfully obtained through a@ Diagnostic OQpen 


for BOLT uses the INIT_RESTORE_TEST routine cf the proper test 


routine is cailed with this variabte sat to <INITAILIZE or 
RESTORE. INITIALIZE tells the test routine to do any program and 
variable initialization required for this teste RESTORE telis 
the test routine to restore program variables and the device back 
to a normal statee Notes: the amount of work required is device 
dependente . 
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DIAGNOSTIC 1/0 INTERFACE 


The MCP oprovides a Diagnostic [0 facility which allows On-Line 
test routines to have “direct” access to the system peripherals 
using HCP communicates.» The following communicates are valid: 


DIAGNOSTIC OPEN 


The Diagnostic Open allows the test routine to gain access to a 
single unit or all units on a control. Access may be exctusive 
only. 


It should be noted that the OnLine test routine need not be 


concerned with the Siagnostic OPEN. When the BOLT operator 
enters the UNIT Commande soecifying a valid units the OPEN on 
that unit 18 done automatically oy B8OLT. [Tf for some reason the 
OPEN should fail» then an error message teliing why 1s displayed 
and tne UNIT coamand has no effect (see UNIT command). Refer to 
INTERFACING A TEST ROUTINE TQ BOLT for an example. 


DIAGNGSTIC ID 


The Diagnostic [0 communicate allows the test routine to do any 
valida I0 to a unit that has been assigned to the program through 
a Diagnostic Open. The program doing the Diagnostic [0 also has 
complete control over the error reporting and retry capabilities» 
normally done by the MCP. The Diagnostic 10 interface has been 
broken up into two Levels for ease of use and maintainability. 
Refer to "I0 INTERFACE RQUTINES™ below for a full explanation. 
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DIAGNOSTIC CLOSE 


The Diagnostic CLOSE conmunicat? reatleasss the specified units) 
back to “CP control. The only restriction on a Diagnostic Close 
is that the unit(s) must nave been assigned to the program 
througn a Diagnostic Qpen.e 


As with the Diagnostic OPEN»es the OneLine test routines need not 
be concerned with the Otagnostic CLOSE. The CLOSE witl be done 
automatically whenever the operator enters the SYEs» RESTART» or a 
valid and successful UNIT Command. If for some reason the 
Diagnostic CLOSE should fail then an error message tetling why is 
displayed and the respective command has no 3ffecte This is trues 
except for the case of the RESTART command. ALl program 
variables will have been brought back to their default stata» 
howevers SOLT witi stitl pe connected to the last unit€s) 
Successfully obtained via the UNIT command. 


IQ INTERFACE ROUTINES 


There are two Levels to the diagnostic I10 interface routines» 
those which the OnLine test routines seep and a general 
diagnostic I10 routine which they do note In most cases» the 
QneLine test routines wiih call one of the visible “tnterface" 
routines with the appropriate parameters whichs in turnse will 


cali the generat 10 routine. The requested 19 3s attempted and 


the result 1s passed back to the calling test routine throausch the 
interface routine. See FIGUREs 3 and 5. 
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FIGURE S - DIAGNOSTIC 10 INTERFACE’ The above  diagran 


jllustrates the different levels of the diagnostic I0 Interface 
and how these routines communicate information between one 
another. In speciat cases a test routine may catl the 00_10 
routines but this is warned against since that routine assumes 
all descriptor fields have been correctty initialized. 
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GENERAL DIAGNOSTIC TO ROUTINE Co0_10) 


The general diagnostic [93 routine is available to the tast 
routines» out will usually o@ catled indirectly by ane of the 
second tevel interface routinas. It has parameters for every 
required field and option of a diagnostic [9 communicate. They 
ar2 as follows: 


le Fike Number “- SDL Otagnostic 10 file 


2. Extended Result | -- requesting extended result 
36 Wait Comolete | -- wait for IG to complete or not 
4. Linked Descriotors -- number of Linked 19 descriptors 


5.- 10 Descriptor Address -~ address of first 190 descriptor 


6e Extended Result Addre 77 address of first extended result 


The communicat® is constructed from these parameters and then 
sent to the MCP. The result-.of the 10 is checked and one of the 
following actions will be taken. 


le. If the communicate failed tnen I[0_FAILURE 15 
returnede (The I0 was never initiated). 


2e If the conmunicate succeeded and there was no 
exception on the i190 tnen I[Q9_ SUCCESS 1s returned 


Se if there was an exception on the IG and retries 
are not requested (Cor RETRY_OVERRICE as TRUE) 
then IOQ_EXCEPTION is returnede Otherwises thea 
op 31S retried. If the op is retried the maximum 
number of times without successfully completing 
then IO_MAX_RETRY is raturned. 


It should be noted that this rautine assumes that 10 descriptors 
have oeen constructed correctly and that ail parameters are 
correcte. 


In addition to duiliding and issuing the Diagnostic 10 communicate 
and returning the result of the IG back to the test routines» the 
general 10 routine (00_10) has some other features which are 
discussed belowe | 
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TRACE DESCRIPTORS 


If the TRACE CESCRIPTORS or TRACE DESCRIPTORS ON or TRACE QON 
command has been entered by the operator then the general 19 
routine (D0_I9) witl display every related I0 descriptor pbefore 
and after it has been issued. 


TRACE DATA SUFFERS 


If the TRACE BUFFERS or TRACE SUFFERS GN command has deen entered 
Dy the operator then the generat [0 routine (00_10) routine wilt 
display every related data buffer area before and after the Iv 
has opeen issued. The format of the display 1s dependent on tha 
HEX and ALPHA commands. The data areas will be displayed to the 
COT and PRINTER if the respective options are turned ane 


RETRY OPS 


The RETRY command sets the number of times that an I0 t5 to be 
retried should 1t complete with an excesotion condition. The 
general [0 routine (DO_I0) controis the retrying or rerissuing of 
16 descriotorse If a sequence of one or more [0 descriptors has 
been retried more than the number of times specified by the RETRY 
command then retries are stooped and an appropriate error code is 
returned. Should a retried {10 descriptor succeed then the return 
code will indicate £9 success» unknown to the calling routine is 
the fact that the I0 was retried. 


Test sections may override the retry facility if necessary. This 
3S accomplished by setting the *RETRY_OVERRIDE* Boolean to TRUE. 
Note that the test section must then implement the RETRY 
facility. | 


Interface routines to this generat i090 routine are discussed 
pelowe They are designed to be a simple means for test sections 
to issue [0 descriptors. 
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SIMPLE _10 


This procedure is one of the second tevel diagnostic ID routines. 
The name has peen chosen beacause this is the simplest 10 
interface for the test routinese SIMPLE_I0 snould be called only 
when all of the following conditions holds 


_ Le NO data transfer 1s beitng done. ‘A data transfer 
requires the beginning and ending address of the 
data buffer being used for the [0. 


If any one of these conditions does not hotd for the I0 to be 


performed then one of the other [0 interface routines is needed. 


SIMPLE _I0 has only one parameter» the op code for tne onderation 
to be attempted. The executive has already obtained the port» 
channal » and tunitt number of the device to be tested (refer to 
UNIT command). SIMPLE_IO calls SET_UP_LDIO_DESCRIPTOR» setting up 
the IG descriptor. Next the 90_I190 routine is called and the Iv 
is attenpted. The general I0 routine (D0_10) returns the rasult 
of the I0 back to this orocedure.e. This result is passed along to 
the calling routine of SIMPLE_iC. 


The calling routine may examine the 10 result and extended result 
descriptors by examining the appropriate fields cf the glodat 
variable "TEST_DESC* and the global variadle TEST_EXT_RSLT>» 
respectivaly Csee NOTE pbetow)., These variabies wilt hold the 
most recent [10 results for atest routines and are reset for eacn 
new IU that ts issued through one of the Diagnostic 10 Interface 
Routinese 7 


NOTE: Extended results are aiways requested when doing an 10>» 
however» not alti devices return an extended result. Therefore>s 
TESTLEXT_RSLT may have no maaning for the most recent I[0. The 


field will be zeroed odefore each IG» however» to avoid any 
confusion. 


geet 
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DATA_IO 
This procedure 1s one of the second level diagnostic I3 routines. 
its purpose is to provide an interface for test routines 
requiring data transfers on the IG. Passed to this routine will 
be the following parameters: 

1. Operation code to be per formed. 


2e Begin address of buffer used in data transfer. 


3- End address of buffer used in data transfer. 


As In tne SIMPLE_[I0 procedures» the diagnostic I0 descriptor is 
1s 


constructad with the supolied information. Then the 19 


attempted by calling the general [0 routine (00_I10). The rasult 
Status of the I10 attempt 1s returned to DATA_I0Q by this routine 
and 1s simply passed along to the calling routine. 


The cailing routine may examine the [90 result and extended result 
descriptors by examining the aoporopriate fields of the global 
vartadDle "TEST _DESC™ and the giobdakl variabdtle TESTLEXT_RSLT» 
respectively (see NOTE below). These variables wili hold the 
most recent [0 results for atest routine» and are reset for each 
new 10 assued through one of the Diagnostic I0 Interface 
Routinese 


NOTE: Extended results are always requested when doing an IQ» 


however» not all devices return an extended resulte Therefores 
TEST_LEXT_RSLT may have no meaning for the most recent I0. The 
field will be zeroed before each [0 to avoid any confusion. 
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SET_UP_ODIQ_CESCRIPTOR 
This is a ganerai orocedtre for setting up [9 descriptors in 


preparation of a diagnostic i[9. Tae following parameters are 
required. 


le 10 DESCRIPTOR -- descriptor to be set up 
Ce OP CUDE -“- the op to ode performed 
3-¢ BEGIN DATA ADDRESS =- begin address of ouffer 
&4&.e. ENO DATA ADDRESS “-- end address of buffer 


The given descriptor is constructed with the sugeplied oarameters 
and control is passed back to the calling routine. 


10 DESCRIPTCR FORMAT 


The format of IQ deserigtors used by 38OLT is given below. Most 
fields will either be set to naraneters provided in 19 INTERFACE 
ROUTINES or set by PCAP commands. Of most concern will be the 
"TO_RESULT" field which will contain the result status of an [9 
operatione Fhe descriptor fields are as follows: 


RECORD DIO_DESCRIPTOR 

ACTUAL_END BIT (24)s Z #R 
IO_RESULT «BIT €24)> % *R 

LO_LINK BIT (24)> % #5 
fO_aP BIT (24)> z *S 
IO_B8EGIN_DATA BIT (24)> % #5 
IO_END_DATA BIT (24)> % «5 
10_DISK_ADDRESS BIT (24)s z #5 
IO0_M_EVENTS BIT € 8)» 8% aNA 
IO_MCP_IQ BIT (16)> % aNA 
IO_FI3 BIT (24)> % «NA 
IOLFIS_LINK BIT (24)> % «NA 
10_SACK_LINK BIT €24)> z NA 


TO_LPORT_ CHANNEL BIT € 7)> 


Where “"«R™ means fields returned by an I0 operation» eS" means 
fieids that must be or can be set by SO0LT» and “*NA™ means not 
applicable. | - | | | 7 
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ERROR PROCESSING INTERFACE 


This section describes the error interface routines provided by 
BOLT. As with the I0 interface routines» there are error 
processing routines which the UnwLine test see and don*t see. 
Upon detecting an errors» the OnwLine tast will call one of the 
higher tLevel error routines. The generat outline of each error 
Interface routine is as follows: 


le. If any one of the disolay options (O0T» PRINTER» or 
ELOG) is oan then the specified error message will 
be read from the crror Fite CeFILe). 


IN 
6 


If OOT is seat then the message read is disolayed to 
the OOT. | 


3e If PRINTER ts set then the message 1s disniayed toa 
the Line printer. 7 


&. Depending on the tyne of errors other information 
may be displayed to the GDT» Printer» and ELOG File 
¥1f those options ara one 


Se All CBOLT) options pertaining to error processing 
will be checked and areturn code indicating the 
action to be taken wiih o2 returned to the test 
routine. See the section on the CHECK_ERROR_OPTIONS 
routine and the section on RETURN CODES for  ~*more 
details. 


ee 


han FE Ce Coe eae Bh ‘ a Pe ( Se AG fe aha Oy eho Toa RB eens fe . Spee laa eS eararees We apy OL en eter eS % - 
. vo A Sa Tea! ‘ Oe bee eg NE a Po Le ae Yate oF Rol ar Pee ee one te ee age re oe) . ey ° ee mae z ace, . 7 . ‘ F 
ca Tag noc nk FE ee Ve teas 8 Aa Repeats Re pao ts Newt aint Ea as wat “et ee A See ed a eS nna tem AS Mee Cb leek ed Ee de tt De te h be ce a Sle Mesa cata a BE ae Le eat ee alice ay cette ad ete eae) LDN 


LO-2 


EURRGUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B19090 BOLT EXECUTIVE 
SANTA BARBARA PLANT PeSe 2225 354308) 


ERROR INTERFACE ROUTINES 


The following error interface routines are those which the 
On-Line routines have access [£06 Exactly which one of these 
routines a test routine wil! call upon detecting an error depends 
on the type of data to be displayad with the 2rror message. 


ERROR 


This routine is catlad by an IAnsLine test routine when it has 
detected an error and the test routine only wishes to display 9 an 
error message and check the error ontions (no result descriptor 
information). Passed to the ERROR_MSG routine as a Darameter 15 
the error message Cequated value) to be displayed Crefer to ERRGR 
MESSAGE FILE. Tne procedure 1s constructed as fotlows: 


PROCEDURE ERROR C ERR_MSG> ERR_NUM ) FIXED? 
FORMAL 

ERRMSG FIXED» 

ERR_NUM FIXEDS 


ERROR_MSG € ERRMSG» ERR_LNUM )> 

ELOG 4SG>s , | 

RETURN CCHECK_ERROR_OPTIONS)> 
END ERROR? © 


See below for an explanation of the ERROR_MSG» ELOG_ MSG» and 
CHECK_LERRGR_OPTIOGNS procedures. The value returned to the 
calling routine reflects the current setting of the error 
processing options and/or any oaderator inpute 
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ERROR_IO 


This routine is callad oy an GneLine test routine when it has 
detected an e2rror on an 10 and tne wishes to cisplay an error 
message» and resuit descriptor information to the ELOG File Cdone 
Oy ISSUINg an ELUG communicate to the MCP). This error interface 
routine does not support any data display. Passed to the 
ERROR_IO routine as a parameter 1s the error message (Cequated 
value) ta be displayed Crefer to ERROR MESSAGE FILE for a 
compiete exnlanation).e. The procedure is written as follows: 


PROCEDURE ERROR_IO (€ ERR_WSG» ERR_NUM ) FIXED} 
FORMAL 
ERR_MSG FIXED» 
ERR_NUM FIXED; 
ERROR_MSG CERR_MSG» ERR_NUM)3 
ELOG_MSG3 
IF ELOG % ELOG OPTION ON 
THEN 993 


¥ 

2 BUILD ELQG COMMUNICATE 
% WITH DESCRIPTOR INFOQ. 
vA a 
he 


ISSUE ELOG COMMUNICATE 

END3 ) | 
RETURN CCHECK_ERROR_OPTIONS)3 

END ERROR_IO3 | : 


See below for an explanation of the ERROR_MSG» ELOG_MSG» and 
CH<CK_ERROR_OPTIONS procedures. The value returned to the 
calling routine reflects the current setting of the error 
processing options and/or any ooerator inpute 
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ERROR_VAL 


This orocedure is called dy an InwLine test routine when it has 
detected an error pertaining to tha comnoar2 of two values. 
Passed ta tcRRUR_VAL 1s the error message (Caquated vaiue) to be 
displayed» and the expected and odtained values found to 
miscomparee The orocedure works as follows: 


PRUCEDURE ERROGR_VAL CERRLUMSGs ERR_NUM> 


EXP_VALUE» OBT_VALUE) FIXED; 
FORMAL 
ERR_MSS FIXED» 
ERR_NUM FIXED» 


EXP_VALUE d317TC24)> 
OST_VALUE B1ITC24)> 


ERROR_MSG C ERR_LMSG» ERR_NUM Jo | 
BUT C€ VEXPECTED DATAS s CAT CONVERTCEXP_VALUE» CHAR ))> 
OUT € "OS3TAINED DATA: . CAT CONVERTCOBT_VALUC» CHAR)D) > 
RETURN CCHECK_ERROR_OPTIONS)> 

END ERROR_VALS 


see below for an explénation of the ERROR_MSG» ELOQG_MSG» and 
CHECK_ERRCR_OPTIONS procedures. The value returned to the 
calling routine reflects the current settino of the error 
processing options and/or any operator inout.e 
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ERROR_3UF 


Tais orocedurea 3s called when an AJntLine test routine detects a 
comoare error in two daté arrays. For examol3,» a tast night wish 
to writ? to a magnetic tape tnen read the data writtens comparing 
two buffers for any errors. The EXROR_GUF routine is calleg 
passing it the error message Ceaquated value)» the two data arrays 
and the length of the obtained data array. The ERROR_SUF 
procedure is structured as follows: 


PROCEOURE ERROR_3UF CERR_NSG» ERR_NUM> EXP_BUFF> 
J3T_BUFF» BUFF_LENGTH) FIXED3 


FORMAL 
ERRMSG FIXED» 
ERA _NUM FIXED» 
EXP_SUFF CHARACTER Ce) 
OBT_BUFF CHARACTER C*)>» 


BUFF_LLENGTH FIXED> 


ERROR_MSG CERR_MSG» ERR_NUM)3 
OUT € "EXPECTED OaTA™ 93 | 
DISPLAY_BUFFER CEXP_SUFF. 3UFF_LENGTH)3 
OUT € "OSTAINED DATA" 93 
DISPLAY_8UFFER CO8T_BUFFs» 3UFF_LENGTH)3 
RETURN CCHECK_ERROR_OPTIONS)3 

END ERROR_BUFS 


See below for an explanation of the ERROR_MSG» ELOG_ASG » and 
CHECK_ERROR_OGPTIONS procedures. The value returned to the 
calling routine reflects the current setting of the error 
processing options and/or any oserator inpute The DISPLAY_SUFFER 
routine 1s assumed to be an iterative routines dispiaying 
BUFF_LENGTH bytes of data from the suffer passed to ite 
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ERAOR_MSG 


This procedure can 52 used Sy a test sactian whenever it destres 
to disolay an error message without displaying values or checking 
the current @2rror aption sattings. The orocedure checks to sea 
if any of the BOLT display options are on. Lf so then the error 
message indicated is obtained from the senarate disk error file 
EFILE. If the ODT option is on then the error message 15 
displayed to the dQOT. Likewise for the PRINTER option. The 
ERROR_MSG routine is written as fotlows: 


PROCEOURE ERROR_LMSG C€ ERRMSG» ERR_LNUM D> 


FORMAL 
ERR_4SG FIXED» 
ERR_NUM FIXED? 


IF (ODT OR PRINTER OR ELOG) THEN 
READ EFILE CERR_HSG] CLAST_MSG)> 
IF OOT THEN 
4 DISPLAY THE FOLLOWING: 


% DEVICE 3EING TESTED == IF ANY 
% SECTION NUMBER -- IF ANY 
% ERR_NUM 

% MESSAGE READ FROM EFILE 


IF PRINTER THEN 
& WRITE TO THE PFILE: 


% DEVICE BEING TESTED <= IF ANY 
x SECTION NUMBER -- IF ANY 
% ERR_NUM 

% MESSAGE READ FROM EFILE 


END ERROR_MSG=> 


ELOG_MSG 


This procedure is called to handie all message displays to the 
Engineering tog CELOG File). No parameters are required. The 
message to be written to tha ELOG File is assumed to have already 
been read from the EFILE and ptaced in the global character array 
LAST_MSG. 


PROCEDURE ELOG_MSG3 
IF ELOG THEN = © | 
«ZIP EM THE FOLLOWING INFORMATION 
2% DEVICE BEING TESTED -- IF ANY 
% SECTION NUMBER -- IF ANY 
2  ERR_LNUM | 
% MESSAGE STORED IN LAST_ MSG 
END ELOG_MSG3 
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CHECA_ERROR_OPTIGNS 


ALL GneLine teast error interface routines wisning to chack the 
error options call this routine to check the current setting of 
the error ootion flags. Depending on these settinscs the 
approoriate action will d2 taken and a return coda wili be 
returned to the calling routine indicating the action to be taken 
by the test routinee error options checked ara HALT ERROR» LOCK> 
and MAXIWUM (Csee the respective commands). The value to be 
returned is recorded in the giobdal variabte "ERROGR_CODE". Thea 
routine is structured as fotLlows: 


PROCEDURE CHECK_ERROR_OPTIINS FIXED> 
SUMP ERROR_COUNTS %Z COUNT ERRORS 
IF HALTERROIR ; 
THEN OD> 


DISPLAY "TEST SECTION STOPPED CUE TO EXCEPTION ON I[/70"35 


GISPLAY "ENTER NEXT COMMAND"; 


INPUT _ CONTROL CTRUE)D> 2 WAIT FUR OPERATOR INPUT 
IF EXIT OR RESTART GR CLEARED OR NEW_LUNIT 
THEN 


RETURN CERROR_CUDE s= RC_INPUT_PRESENT)> 
END> _ | 
IF ERROR_CQUNT EQL MAXIMUM_VALUE 
THEN D0, oo | : 
DISPLAY "MAXIMUM NUMBER CF ERRORS REACHED,» 
RETURN CERROR_CODE s= RC_TOO_MANY_ERRORS)>; 


END 
IF LOCKERROR 
THEN DQ3 
IF NOT LOCKED 
THEN DOS 
- - POSITION_LOCKED_ON = LOCK_POSITIONS 
LOCKED s= TRUE3 | 
| ENDS | 
ENDS | 


RETURN CERROR_CODE 2= RC_CONTINUED3 
END CHECK_ERROR_OPTIONS; 
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MESSAGE 


This routine orovides a means for test routines sand test sections 
to read messages from tne Erle. Messages may be error messages 
or informative messages for the operatore for instances» ane Line 
Printer Test Section may require that the Line Printer o8ing 
tested is NOT READY. The message requesting tne operator to make 
the device NOT READY» can be storad in the EFILE. This also 
allows for easier maintenance of output nessagese The MESSAGE 
procedure is written as follows: 


PROCEDURE MESSAGE CMSG_NUM) CHARACTER VARYINGS 
DEFINE 
MSG_NUM FIXED? 
| DECLARE | 
MSG CHARACTER (30)3 


READ EFILE LMSG_NUM] (MSG)3 | 
% STRIP OFF TRAILING 3LANK3» LEAVE ONE 
RETURN (MSG)3 

ENO MESSAGES 


\ | 
& A few sample uses of this procedure and the resulting output is 
Shown belowe The reader should notice the versatility of this 
routines) | . : 


SOURCE: OISPLAY € MESSAGECPLEASE _NOT_READY) D> 
QUTPUT2 PLEASE NOT READY THE SELECTED LINE PRINTER, 


SOURCES DISPLAY € MESSAGECWRITE_FAILED) CAT 
CONVERT CDECIMAL CLINE_LNUMBER® 3)% CHARACTER) D> 
OUTPUT? THE WRITE OP FATLED ON WRITE NUMBER 126 


Utility» and Informative messages are placed into the EFILE in 
the same way that error messages are.» See tha next section which 
explains more about error messages. 
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ERROR MESSAGE FILE 


Error messages are found 19 3 Separate disk files» internatly 
known to BOLT as EFILE. When thea ERROR_MSG routine is catled it 
is passed a message numter.e This numder 15 the position of tna 
appropriate error message in EFILE Czero relative). The error 
message is read from the file and disptayad where necessary, 
depending on the current display option settings. 


When a test 1s betng designed and coded the orogrammer  § shoutd 
recagnize and record all required error messages. Once the test 
is ready to be compiled the grogrammer will have to define the 
error messag2 mnemonics and enter the actual messages into tha 
appropriate spot in the error file CEFILE). ror examples, if a 
test routine wishes to display a message indicating a parity 
error on a read operation the following steos would pe taxen: 


le DEFINE 
READLPARITY_ERROR AS # 45 43 


2. Enter the actual message in the error file at 
the 45*th position» O retiativee. Looking at 
a portion of the error fil2 one mignt sees: 


<record 43>: INVALID KEYWORD. 
<record 44>: EXPcCTING A ™s"* BETWEEN COMMANDS. 
<racord 45>: PARITY ERROR DETECTED ON READ OP. 


3e When an error occurs catl the appropriate 
routine passing it the error anemonice Such 
as? | 
CRROR_IO CREAD_PARITY_ERROGR»e ERR_NUM)> 


An example of how an error message might be displayed to a given 
output device is given belowe This is not necessarily the fora 
of the display for all devices. | 


ERRGRs Coodle TEST: MTA TASK: SECTION 3 
PARITY ERROR DETECTED ON READ OP. 

POSSTB8LE FAILURE OF INTERFACE LOGIC 
EXPECTED DATA aCiC2C3C4C5C6C7C38a 

RECEIVED DATA <JICIC2C3C4FFCOC7CSS © 

ERRORS : te te 
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UTILITY PROCEDURE INTERFACE 


Fotlowing are a list of miscellaneous generat opurpose routines 
that are declared in the BOLT executive and may be used by the 
test routing. 


BOJ_SECTION_MSG 


A catl to this procedure should oe the first statement of every 
test sactian.e The procedure requires ona oarameter which is a 
Character strings not to exceed 59 characters» containing the 
following information: 


?T3IEGIN SECTION <#>: <section name>.” 


The S8OJ_SECTIOGN_MSG orocedure wilt anopend the unit anemonic of 
the unit bdeing tested to the front of the supplied message. 
<section name> is the name of the test section that is currently 
being executed. An example catl from a test section would be: 


BOJ_SECTION_MSG C"™BEGIN SECTION 1:2 END ADDRESS TEST.%)s 


The procedure wilt output the message only if the 80J option has 
been selected by the operator and the section is not deing 
repeated. The cutput witli go to the ODT and the PRINTER 1 both 
options have been sete 
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EQJ_ SECTION_MSG 

A call oto this procedur2 snould be near tha end of every test 
Sectione The procedur@ requir2?s ona parameter which is a 
cnaracter strings not to exceed 50 characters» containing the 


following information: 
"END SECTION <#>:3 <section name>." 


The EQJ_SECTIOQN_MSG procedure wilt append the unit mnemonic of 
the unit obdeting tested to tne front of the supplied messagee 
<section name> is the name of the test section currently being 
executed. An example call from a test section would pes: 


EQOJ_SECTION_MSG CEOS SECTION 13 END ADDRESS TEST.%)> 


On the tine fotlowing the message just described» this orocedure 
will display the number of errors detected in the test section 
just comolatede The messages will only be displayed if the 82@J 
option has deen selected and the section is not being repeated. 
The output wiih go to the GOT and the PRINTER if both options 
nave been sete | 


FILL _ BUFFER 
This procedure may be called by any test routine to fiil a given 


buffer with a given pattern. Passed to this routine are the 
following parameters: 


le. SUFFER -- puffer to be filled with pattern 

2e BUFFER_LEN == tength of the buffer to be filled in bits 
30 PATTERN © = data pattern to put into BUFFER 

4e PAT_LEN =- Length of the data pattern in bits 


The specified pattern is repeated or truncated» if necessary» to 
fill the SUFFER. See the TEST ROUTINE EXAMPLE section for 
examples of how to use this and other utility routines. 
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PATTERN 


This orocedure is called wnen a test section wishes to filt a 
buffer with a ocredefined pattern. Passed to this procedure are 
the following parameters: 


1. BUFFER “- the buffer to be filled with the pattern 
2e BUFFER_LEN == Length of the buffer to be filled 
32 PAT_NUM “-- number of the pattern to be used 


When caltlad» this procedure checks first to make sure that tha 
pattern soecifisd 31s a velid one (refer to the DATA command for a 
List of valid pattern indecies)e Once the pattern index has been 
verified» the given buffer is filled with the pattern» repeating 
or truncating where necessarye This procedure calls the 
FILL_SUFFER procedure to actually fill the SUFFER with data. 


COMPARE_BUFF 
A utility routine orovided for COMPARE command and all test. 
procedures for comparing two data areas. Passed to this 


procedure are the following parameters: 


1. — *REC_ BUF | the buffer to be copostes with the standard 


one. 
2e EXPEC SUF the standard buffer. 


3e EXPECTED_LEN Length of the standard buffer in bits. 
4. NO_OF_BITS number of dits to be compared at atime (4 


/ 8). 
Se OISP_FLAG a boolean to tndicate if the buffers are to 
be displayed in the case of 8 data 
|  §iscompare. | 
Ge ERR_NO error number Cfor test procedures). 


7e RESULT_FLAG a boolean that witt be set if compare is 
| Successful. | 


The procedure returns a fixed value. where the value returned 
Sshoutd be checked, by the test procedures in order to take an 
appropriate action in case of eas miscomparee 


When calted> this procedure compares the contants of the REC_ SUF 
with that of EXPEC_B8UF by NO_OF_3ITS bits at a time. It shoutd 
be noted that the test procedures should check the HEX and ALPHA 


options and set NO_OF_SITS accordingly. If the HEX option is ons 


the data should be compared in four bit quantitiess if the ALPHA 
option is sets» the data shoutd be compared in eight bit 
quantitiess if both options are sete ene aoe engune be coepered 


in four pit wesbiactel esate ate ow ee 
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If a data miscompare 1S detected» the procedure cails ERROR 
routine if ERRNO is not 1; otherwise» at anly informs the 
operator of tha data mismatch. So if any of the test routines 


wisn to check the error ootions and racord the error message tn 
the Elda files it should call this routine with ERR_NO set to 
anything but cl. 


The procedura»y if the DISP_LFLAG is set» then displays 45 
characters of “EXPECTED” and "Q8SSERVED" data to the ODOT beginning 
at the character boundary of the data tn error if the ODOT oaptton 
is One It displays the entire buffers to the printer tf the 
PRINTER option is sete The decimal position of the first HEX 
digit or ALPHA character is displayed at the beginning of each 
Line In parenthestse Compare errors are marked with asterisks 
(*) on the line tithed “ERRORS™ for aach HEX digit or ALPHA 
character in error. 


If neither SOT nor PRINTER are sats» the operator is informed and 
buffers are not displayed. 


DISPLAY_IO_RESULT 


A utility routine provided for all test procedures for uniforms 
output of I0 descriptor results. Passed to this routine 1s the 
"TO_RESULT™" field af the 10 descriptor in question. The result 
field is displayed following a tLabet identifying it. . 
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WAIT_FOR_INPUT 


This utitity procedure is for test sections only. It is provided 
so tnmat test sections may Oring BOLT to an idle state» waiting 
inpute For example» a test section in the LINE PRINTER TEST 
might want to stop temporarily and wait for the operator to ready 
the printer that is being tested. The WAIT_FOR_INPUT routine is 
a boolean procedure where the vatue returned means: 


TRUE -- the operator entered an EXIT» CLEAR» RESTART» 
or UNIT commande. The test procedure is to be 
halted. 

FALSE =- the GQ command was entered and the test is to 


continue. 


A typical use of this utility routine would oe as follows: 


DISPLAY (MESSAGE € MSG_NUM ))>5 
IF WAIT_FORLINPUT THEN RETURN CRC_LINPUT_LPRESENT)s; 


For this example» we wilt assume that MSG_NUM is a defined 


mnemonic equated to a numeric value; that value being the 
position in the Error File CEFILE) of the message “PLEASE READY 
THE LINE PRINTER THAT IS BEING TESTED.*™. The message i138 


displayed and BOLT is brought to an idle» waiting input state. 
The operator should ready the Line printer in question. Entering 
a GO command wilt continue the test section currently being 
executed. po 7 
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ACCEPT_AN_ANSWER ; : 

This boolean procedure allows interaction with the user. The 
user is asked to supply a yes or no input to the OOT. Thea 
procedure returns a boolean according to the entry: al for yes 
and a Q for no« Onty yes or no will be accepted. The routine 


loops until either is supplied. 


CHECK_FOR_INPUT 


CHECK_FOR_INPUT is a boolean procedure which checks to see if the 
operator has entered any tnput on the QOT. A call to this 


routine must be made before every test section fragment that 1s 


labeled with a “LOCK _POSITION®W (see GLOBAL VARIABLES and the TEST 
ROUTINE EXAMPLE). The CHECK_FOR_INPUT routine returns values 
having the following meaninge ) 


TRUE =- the operator entered an EXIT» CLEAR» RESTART» 
or UNIT command. The test procedure 1s to ba 
haited. 

FALSE -“- the GO command was entered and the test is to 


continues or no input has been entered. 


A typical use of this utility routine would be as follows: 


BUMP LOCK_POSITIONS 
IF CHECK_FOR_INPUT THEN RETURN CRC_INPUT_PRESENT)3 


os 68 


eax error check or IQ attempt & & t 
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CHECK_HALT_AFTER_IO 


This boolean oprocedure checks to see if the operator has 
requested JOLT to halt after each IG (see HALT command). If so» 
then pBOLT will go to an idle» waiting input state. A call to 
this procedure must appear after the 10 request or error check of 
ever y test section fragment that is tabeled WwItn a 
*LOCK_POSITION™. Values returned by this procedure have the 
following meaning: 


TRUE == =" the operator entered an EXIT» CLEAR» RESTART, 
or UNIT command. The test procedure 1s to be 

halted. 
FALSE. -- the GQ command was entered and the test is to 


continues or the option to halt after each ID 
Was not turned one 


A typical use of this utility routine would be as follows: 


ee $e 


#*x* error check or I0 attampt «x 


IF CHECK _HALT_AFTER_IG THEN RETURN CRC_LINPUT_PRESENT)> 
IF LOCK_POSITIGN FQL POSITION_LOCKED_ON- 
THEN : , 
RETURN CRC_LOCK)>; 


The Line of code checking to see if the LOCK_PGSITION is equal to 
the POSITION_LOCKXED_ON shows how test sections implement the LOCK 
commande In the following section of this decument a acdel test 
section fragment 1315 shown ta give the reader a better 
understanding of how some of these “required” utility routines 
are used.e. After that an example tast routine is given. 
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TEST ROUTINE EXAMPLE 


Following 1s a test routine exampie which demonstrates the use of 
some of the ID interfaces, ERROR interface» and utility routines 
of cULT. This test routin2 example also shows the reader how to 
use return codes returned by these tnterface routines» and how a 
particular test section is called. Before iocoking at the test 
routine example» however» it is necessary to show the reader what 
a model test section fragment should look like. Following that 
several test sections are canstructed from these fragments» 
showing the overatl construction of an "example™ test routine. 


TEST SECTION FRAGMENT 


A model test section fragment is shown in FIGURE 6 below. A test 
section fragment 1s defined as being any [0 attempt or error 
check required tin a test section. The required format of each 
fragment consists of the fotlowing Cin the order given): 


a le The global variable "LOCK_POSITION" is bumped to the 


hw) error Cor set to one if this is the first test section 


fragment in the test section). This variable is used 
for the tock option and for indicating error positions 


2. A call to the "CHECK_FOR_INPUT” routine is made to see 
if the operator has entered any input. 


3. The I0 is attempted or the Error Check is made. 

4e A call to the “CHECK HALT_AFTER_IO" routine is made to 
see if BOLT is supposed to halt after the 10 or Error 
Check. | 


5S. The "LOCK _POSITION" and *POSITION_LOCKED_ON” variables 
are checked to see if BOLT is tocked on this error. 


Other tasks may be performed before and after any of these. 
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2* MODEL TEST SECTION FRAGMENT x 
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2 


ae ¢e 66 


possioly other test section fragments 


BUMP LOCK _POSITIONs 
IF CHECK FOR_LINPUT THEN RETURN CRC_INPUT_PRESENT )> 


t possible code to set up of I0 descriptor for 
2° upcoming I0. 
keazkxex the I0 or Error Check **x*2* 
‘ 
-. 3 if an unexpected error occurred then cail 
> of the Error Interface routines. Possible 
3 that the test could be haited. 


IF CHECK_HALT_AFTER_IQ THEN RETURN CRC_LINPUT_PRESENT)3 
IF LOCK_POSITION EQt POSITION_LOCKED_ON 
THEN RETURN CRC_LOCK)> 


oe 66 60 


FIGURE 6: - MODEL TEST SECTION FRAGMENT. This figure gives the 
essential parts for every test section fragment. 
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SS en@weqee wa ee ow oe a ee en eee ee seme me semen ewe eee eneen nena 


E TEST PROCEDURE DESIGNED TO 
HOW THE TEST PROCEDURES 
HOW THE OLAGNOSTIC 19 


HOW BOLT UTILITY ROUTINES 


MRMWeMwMMWNRMRMNM RE MH MHRRRENRNANRN NNN NN NW 


ARE USED> AND MORE. THE TEST CASES SHOWN MAY NOT NECESSARILY DE- 
PICK ACTUAL TEST CASES. = see THIS TS ONLY AN EXAMPLE * eax, 
IN SOME PLACES» PSUFDO-CODE IS USED. PSUEDD-COOE SHOULD NOT BE 
CONFUSED WITH ACTUAL CODE. 
+ . | | | 
PROCEDURE LINE_PRINTER_TEST ( SECTION_NUMBER ) FIXED$ 
- FORMAL | te haeae oe 
SECTION_NUMB&ER FIXEDS 


sy taht so ae aes AA gee ie 
86 td Oh ae ata? See ai ele 
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fmt nn nn en rn nn ren ce nnn nnn nnnee- ween nee nee nneneny 
+ PRINTER ERROR MESSAGE DEFINES & 
f~ewenmwoeat aan anenwwanaeaeesaeaes @<ea @eesaiaa:sas @ SS SS Behe BF Oeeanwmeaeseewewaeae rs a2aeaeese aa. @& @ ewwanecuneon 7 
DEFINE 
TEST_OP_FAIL AS #75 ft» 
SGL_WRITE_FAIL | AS t 76 #» 
DBL_WRITE_FAIL | = wv 385 # 77 >» 
SECTION_ABSORTED AS «#78 Be 
NOT_RESPONDING AS # 79 #e 


i OP’ER ATIGQN- CODES Y SE OD yA 


Op_TEST AS # 38C0CC02 #> 
OP_SGL_WRITE 2 AS # 34600009 #> 
OP_OBL_WRITE AS # 34F00000 #3 


+ VARIABLE S USE O IN TEs T % 


‘ asa an nant aenann sean eeanasneaaawDaonaaae CEM GIO MM MA Mh MSs WRB eewBweese se ee wwe SF Oe 6 we ee aww wm 7 


DECLARE - 3 : 
LEN — BIT Cia)» * LENGTH OF DATA FOR OP 
WRITE_DATA BIT (M4AX_DATA_LEN)» % DATA SUFFER FOR WHITE 
IOLRESULT FIXED» 
ERROR_RESULT | FIXED> 
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teccee= oceeses----- wn on ee en ne cen ene em wen ee cece sneeseesse-- enenn=% 
+ : z 
+ FroetkL PRINTER 9 UF FER y 4 
+ 2 
$e eee ce wee new enews en cee manne sense cee sce wenn an wenn seen saaesenneueeony 
+ _ = | yA 
+ THIS PROCEQURE [IS CALLED BY TEST SECTIONS TO FILL THEITR DATA &% 
+ BUFFER WITH EITHER A DEFAULT DATA PATTERN QR USER PROVIDED DATA. 2% 
+ PASSED TO THIS PROCEDURE AS FORMAL PARAMETERS [5 THE FOLLOWING 2% 
+ INFORMATION: : v4 
+ oS —— x 
+ 1. BUF “-- BUFFER TO BE FILLED WITH DATA yA 
+ 2e OBUF_LEN “- LENGTH OF BUF. a 
+ 3e PAT @- DEFAULT PATTERN TO BE PLACED IN BUF ys 
+ Le nese “= LENGTH OF THE OATA PATTERN PAT. y4 
+ a 
+ IF THE *"USE_DEFAULT_DATA™ FLAG IS TRUE THEN THE CEFAULT DATA PAT~ & 
* TERN IS USED. OTHERWISE» USER ENTERED DATA IS USED. THE GLOSAL % 
+ UTILITY ROUTINE "FILL SUFFER” IS USED TO ACTUALLY FILL THE BUFFER. 2% 
+ a 
$e ee ew ee ce cena eee sae tee see cena ene em e emma enema eases aa neea non y 


PROCEDURE FILL_PRINTER SoU Ereks. COUF> eee eae PAT » PAT_LEN)S 
FORMAL 7 | 


BUF | BIT VARYINGS | 
FORMAL_VALUE 7 
BUF _LEN FIXED» 
PAT BIT VARYING» 
PAT_LEN FIXED; ) 
IF USE_DEFAULT_DATA 
THEN 3a . | 
FILL_BUFFER (BUF» BUF_LEN» PAT» PAT_LEN)3 % DEFAULT DATA 
ELSE 


| ap i eae BUFFER CBUF >» pone Pee DATALARRAY» 256%8) % GPERATOR DATA 
+ : ) | 
END FILL _PRINTER _SUFFERS 
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fo etn ene ne ene nnn e ree ------ eet eee % 
+ rs 
+ P TR R I PPLE yA 
+ SECTION #1 a 
8 8 eS SS Se SS SS ee es a m4) «2 @ 2 @Seeneoeaeeaeee ae we seanwecoweaweon Y 
+ z 
+ THIS IS A SAMPLE TEST SECTION. THOUGH THERE WILL ACTUALLY SE A 2 
+ “PTR URIPPLE*™ TEST SECTION IN THE LINE PRINTER TEST» THIS IS NOT 2 
+ WHAT THE TEST SECTION DGESs» AGAIN» THIS IS ONLY AN EXAMPLE TEST 2 
+ SECTION. pA 
+ —_ x 
# SEQUENCE OF OPERATIONS: yA 
+ —_ r4 
+ 1. TEST OP TO THE PRINTER. yA 
+ yA 
+ 2e SINGLE SPACE WRITE OP TO PRINTER. ODOATA IS 80 CHARACTERS x 
+ OF REPEATING PATTERN "ABABABe we oe 4 
+ , yA 
+ 3e DOUBLE SPACE WRITE OP TO PRINTER.j DATA IS 132 CHARACTERS ¥ 4 
+ OF REPEATING PATTERN "COCOCD ce oe es 4 
+ | % 
+ THIS PROCEDURE RETURNS ONE OF THE RETURN CODES DESCRIBED IN THE & 
+ "GLOBAL DEFINES" AND "TEST_UNIT™ SECTIONS OF THE DOCUMENT. yA 
+ | | ‘ Cm Y 
Patents eesst ean Gan een avast aannnanatse ann naneesasneenaensanaanawanea se - Fe eg Ue US Seen e «2 @ = a = vA 


PROCEDURE PTRLRIPPLE FIXED; 


BOJ_SECTION MSG C€ "PRINTER: BEGIN SECTION 13 PTRLRIPPLEW~")>; 


S+RREKEKKEKEKKEKKEKEEZ 


#xex LOCK #1 «x 


SERAEEERAEKEKAERERKRKEEREK 


+ 


LOCK_POSITION = 13 — 


IF CHECK_FOR_INPUT THEN RETURN CRC_INPUT_PRESENT)3 
IF SIMPLE_I0 COP_TEST) NE@ IG_SUCCESS | % wee ID eee 
THEN IF ERROR_IO CTEST_OP_FAIL»1) NEQ RC_CONTINUE 


THEN RETURN CERROR_CODE)$ 


% RETURN STOPPING REASON 


IF CHECK_HALT_AFTER_I0 THEN RETURN CRC_INPUT_PRESENT )3 
If LOCK_POSITION EQL POSTITION_LOCKED_ON THEN RETURN CRC_LOCK)> 


\ 
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+a LOCK #2 x 


+ ReEKRKEREKKEEKKEKERE 


+ 


BUMP LOCK_POSITIGN; 
IF CHECK_FOR_INPUT THEN RETURN CRC_INPUT_PRESENT)> 
FILL_PRINTER_QGUFFER CWRITE_DATA» COLUMNS» "AB"™s 2*CHARS)3 
IF DATA_i0 ( OP_SGL_WRITE>» : 
DATA_ADORESS CTEST_DATA)>» 
DATA_ADDRESS CTEST_DATA) # LEN» 
} NEQ Yf0_SUCCESS Z WRITE OP UNSUCCESSFUL? 
THEN IF ERROR_IO (SGL_WRITE_FAIL»2) NEQ RC_CONTINUE 
THEN RETURN CERROR_CODE)3 
IF CHECK_HALT_AFTER_IG THEN RETURN CRC_INPUT_PRESENT)3 
IF LOCK_POSITION £9L ERROR_LOCKED_ON THEN RETURN CRC_LOCK); 


+eeEK&KkKK&XRKEKKEKREKAK 


+k LOCK #3 x* 


PRMERAEKEKEKRKEKKEAKRAE 


+ 


| yet 
/ 


+ 


BUMP LOCK POSITIONS | 
IF CHECK_FOR_LINPUT THEN RETURN CRC_LINPUT_PRESENT)> 
FILL_PRINTER_BUFFER CWRITE_DATA» COLUMNS» “"CD"» 2*CHARS)> 
IF DATA_IO € CP_D3SL_LWRITE> | 
~DATA_LADDRESS CTEST_DATA) » 
DATALADDRESS CTEST_DATA) + LEN» 
» NEG ITO_-SUCCESS % WRITE IS UNSUCCESSFUL 
THEN IF ERROR_IO COBL_LWRITE_FAIL»®3) NEQ RC_CONTINUE 
THEN RETURN CERROR_CODE D> . 
IF CHECK_HALT_AFTER_IO THEN RETURN CRC_LIEINPUT_PRESENT D> 
IF LOCK _POSITION EGL POSITION _LOCKED_OQN THEN RETURN CRCO_LOCK)> 


EDJ_SECTION_MSG ( "PRINTER? END SECTION 1: PTR_RIPPLE™)3 
RETURN CRC_CONTINUE)3 _e © | 


END PTR_RIPPLE? — 


++ eee teree hee eee teeee eee + 
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SECTION #2 


THIS YS A SAMPLE TEST SECTION. THOUGH THERE WILL ACTUALLY 3E A 
"PTRUALIGN™ TEST SECTION IN THE LINE PRINTER TEST» THIS TS NOT 
WHAT THE TEST SECTION DOES.» AGAIN» THIS IS QNLY AN EXAMPLE TEST 
SECTION. 


SEQUENCE OF OPERATIONS: 
1. TEST OP TO THE PRINTER. 


2. IF FIRST TEST SECTION FRAGMENT CTEST OP) COMPLETES WITH 
NO ERRORS THEN 00 A SINGLE SPACE WRITE OP TO THE PRINTER 
WITH A 132 CHARACTER LINE OF ALL H'?S. SUCH A LINE COULD 
BE USED TO VERIFY CHARACTER ALIGNMENT VISUALLY. THE LINE 
IS PRINTED 20 TIMES. 


THIS PROCEDURE RETURNS QNE OF THE RETURN CODES CESCRIBED IN THE 
"GLOBAL DEFINES" AND "TEST_LUNIT™ SECTIONS GF THe DOCUMENT. 
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) PROCEDURE PTR_ ALIGN FIXED> 


+ehoee hh t + + 


he 


BOJ_SECTION_MSG ( "PRINTER: BEGIN SECTION 2: PTR_ALIGN.")3 
SREKEKRAKRKEKKERKEER 

$2 LOCK #1 «x 

SRERRARKRRERKRKE REAR . 

THIS SECTION IS ALMOST LIKE LOCK #1 IN THE ABOVE TEST SECTION. 
THIS SECTION SHOWS THE FOLLOWING: 


1- ALTERNATE WAY OF LOOKING AT RESULT OF [9 

2e ALTERNATE WAY OF LOOKING AT ERROR ROUTINE RESULT 

Se HOW ONE CAN DISPLAY 10 RESULTS USING A UTILITY ROUTINE 
4. HOW MESSAGES CAN BE DISPLAYED BY TEST ROUTINES 


LOCK_POSITION = 13... | 
IF CHECK_FOR_INPUT THEN RETURN CRC_INPUT_PRESENT)3 
IO_RESULT = SIMPLE_IO COP_TEST)3 % waane TEST OP waane 
IF IO_RESULT NEQ@ Ig_sUCCESS % LOOK AT OP RESULT 
THEN DG5 
| ERROR_ RESULT := ERROR. 10 (TEST _OP_FAIL» 1)3 
-DISPLAY_IG_RESULT CTEST_DESC.1D -RESULT)3_ 
QUT (MESSAGE (NOT_RESPONDING))3 % A MESSAGE 
IF ERROR RESULT. NEQ RC_CONTINUE THEN REUTRN CERROR_RESULT)3 
END? 
IF CHECK_HALT_ AFTER. ‘10 THEN RETURN CRC_INPUT_PRESENT)3 


BE HR TS HR EE HR RE TS HEM FE FE HE TE TE REN HM FE NK TB LK FE 
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(_) teeeeaeeseneneens 
22. LOCK #2 ««* 


+XKRKAEKKRKEAEEKEKKRES 


tp 


+ THIS TEST SECTION DOES WHAT IS STATED IN THE PROCEDURE HEADING. 
+ THIS TEST SECTION SHOWS THE FOLLOWING: 
+ 
+ le HOW TO LOOK TO SEE TF FHE PREVIOUS I06 HAS FAILED OR NOT. 
+ 2e HOW TO ABORT A TEST ROUTINE DUE TO ERRORS DETECTED. 
+ 3e HOW LOOPS IN TEST SECTIONS SHOULD SE NUMBERED CLOCK_POSITION). 
+ 4e HOW A TEST ROUTINE DISPLAYS AN INFORMATIVE MESSAGE. 
+ 
+ 
IF EXCEPTION_FOUND | & TEST OP FAILED OU NOT 
THEN DOs & CONTINUE ON WITH TEST 


ERROR_MSG (SECTION. ABORTED)» 
RETURN CRC_ABORT_SECTION)? 
END> 


BUMP LOCK_POSITIONS % ERROR NUMBER 2 
LEN s= COLUMNS? 
FILL_PRINTER_SUFFER CWRITE_DATA» COLUMNS» "HH™s 2eCHARS)3 
I s= 03 
00 H_LINE FOREVER; 
_ IF CHECK_FOR_INPUT THEN RETURN CRC_INPUT_PRESENT)3 
C) | 1Q_RESULT t= DATA_IO € OP_SGL_WRITE> 
| . 4, DATA_ADDRESS CWRITE_DATA)> 
— DATA_ADGRESS CWRITE_DATA) + LEN 
3 
IF IQ_RESULT NEQ@ IO_SUCCESS 
THEN IF ERROR_IO CSGL_WRITE_FAIL»2) NES RC_CONTINUE 
THEN DO; 
OUT C MESSAGECSGL_WRITE_FAIL) CAT CONVCDECCI+1»2)>-CH)3 
RETURN € ERROR_CODE )3 
ENDS a 

IF CHECK_HALT_AFTER_IO THEN RETURN CRC_INPUT_PRESENT)3 

IF (BUMP I) GEQ 29 THEN UNDO H_LINES 
END HLINES | | | 
IF LOCK_POSITION EQL POSITION_LOCKED_ON THEN RETURN CRC_LOCK)3 


a 


—EQUJ_SECTION_MSG ( "PRINTER: END SECTION 2: PTR_ALIGN"™)3 
RETURN CRC_CONTINUE)S; 

+ | | 

END PTR_ALIGNS 


“e,, 
af 
H 
, 
4 
oe 


ast -cisnahipac nmectaaiy eitasilpiobanidprent neti ara Aria 


ST eee ee ee mee cet nner nem ee ee ee em ed ee ee a ele ee hale et nate ca ie cine NSS lle De raw a 


i2-19 


BURROUGHS CORPORATION COMPANY CONF ICENTIAL 
COMPUTER SYSTEMS GROUP 31000 SOLT cXECUTIVE 
SANTA BARBARA PLANT | P.Se 2228 3543 (A) 
E'y seetiistaaselinsiaiainiiil sillier nintantetciden acai 
ot % 
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+ PA 
+ THIS PROCECURE IS REQUIRED IN EVERY TEST ROUTINE THAT 4UST D020 SOME & 
+ KIND OF INITIALIZATION QR RESTORATIGCN ON THE DEVICE TO BE TESTED ££ 
OR THE TEST ROUTINE ITSELF. COMMENTS» RATHER THAN LINES OF CODE» 2% 
+ ARE GIVEN BELOW TO INDICATE WHAT THIS ROUTINE POSSIBLY MIGHT O90 TO % 
* TO INITIALIZE OR RESTORE PRINTER DEVICES AND THE LINE PRINTER TEST & 
+ ROUTINE.’ THESE ACTIONS MAY NOT REFLECT ACTUAL TEST ACTIONS. % 
+ % 
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PROCEDURE INIT_RESTORE_TEST CINIT_OR_RESTORE) >; 


IF INITLOR_LRESTORE EQL INITIALIZE 
THEN DO INIT_PRINTER> 


GET THE CONTROL ID 
GET THE CHARACTER SET SIZE FOR PRINTER TRAIN 
SET GLUSAL VARTIASLE "COLUMNS™ TO 132 CHARACTER BITS 


ei ri eM NK 


END INITLPRINTER> 


; n | 
CC ELSE od RESTORE _ PRINTER 
A 
2 IF CONTROL Ip INDICATES PRS/S THEN MAKE SURE 
yA THE TRANSLATOR MEMORY IS LOADED BEFORE RETURNING 
pA ; 
% 
END RESTORE_PRINTERs 
END INIT _RESTORE_TEST> 
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CASE SECTION_NUMGER> 


RETURN INIT_RESTORE_TESTS % INITIALIZE/RESTORE TEST AND DEVICE 
RETURN PTR_RIPPLES % SECTION #1 
RETURN PTR_ALIGNS % SECTION #2 

: SECTION #3 


% SECTION #N 
END CASE; 
END LINE_PRINTER_TEST3 


Pa 
f 4, 


Paes ' 
Lo — 


eoskde cee cbceteis Gide Gltsdetes Sula ea oka eect ine keteme inlet wiews Cus, Cas sacs chu eae susee Oe e ee ceecd bie ceil elo ins Sn tte Gone teh iaees: bce Uee a ree Sante Ob) Tene TO Sine aaa Sa a te, ee oe ei ie ab Ceca Ys we ae can Mam eee te ek ae Ol Soha MAL Rees ha Fiat eS 


COMPARE COMMAND 


IX-1 


EURROUGHS CORPORATION © COMPANY CONFIOENTIAL 
COMPUTER SYSTEMS GROUP B1i000 BOLT EXECUTIVE 
SANTA BARBARA PLANT PeSe 2223 35435TA) 


ABOUT ONW*LINE FEST ROUTINES * ae | 
ACCEPT_AN_ANSWER 116 

ADDRESS COMMAND So 
ALPHA COMMAND 374 


o 


BEGIN_ERROR_COUNT TYPES FIXED a 
BOJ COMMAND 375 

BOJ_SECTION_MSG pO tae | 

BOLT i=5 

BYE COMMANDO 3-6 


CALLING TEST ROUTINES FROM BOLT 6-3 
CHAIN COMMAND 3-7 
CHECK_ERROR_OPTIONS 19-7 
CHECK_FOR_INPUT 1176 | 
CHECK_HALT_AFTER_IG 11°7 
CLEAR COMMAND 3-8 
COMMAND 1°35 3-2 
COMMAND SYNTAX 3-1 
COMMANDS 5-3 
COMMENTS 5-3 

3-9 
COMPARE_BUFF 1173 
CONFIDENCE TEST 12 
CONTROL 1-3 


"5 


CONTROL_SELECTED | TYPE? BOOLEAN p< 
CONTROLS AND DEVICE TYPES 4-9 

CURRENT _PORT_CHANNEL TYPEs 3B1T (7) 373 
CURRENT_UNIT_NUMSER TyPEs BIT (4) 365 


CYCLE COMMAND 5710 


DATA COMMAND 3-11 
DATA_IO 9-7 
DEFAULT i-3 
DEFINITIONS 1-3 
DELAY COMMAND: 3°14 


DESIGN GOALS 21 


DEVICE i7s 7 ae | | 
DEVICES_IN_USE . a TYPES S800LEAN ag 


 ODFILE 55 


DIAGNOSTIC CLOSE 9-2 °° | 
DIAGNOSTIC I/O INTERFACE 9-1 


— DIAGNOSTIC 100 9-1 
DIAGNOSTIC OPEN 972° 0° °° 
DIAGNOSTIC TEST 1-3 
 DIOFILE iw Pie er hy 
DISPLAY COMMAND) 37150 2 © 


poems 


} 


( 
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INIT_RESTORE_FLAG 


LINK COMMAND 
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DISPLAY_IQ_RESULT 11-4 | 
DYNAMIC MEMORY ALLOCATION 4-11 
EFILE 35-5 
ELOG COMMAND 
FLOG_MSG 10-6 
ENTERING COMMANDS 4 
EQU_SECTIGN_MSG  11- 
ERROR 10-2 

ERROR INTERFACE ROUTINES 
ERROR MESSAGE FILE 10-9 
ERROR PROCESSING INTERFACE 
ERROR_BUF 10-5 
ERROR_CODE TYP 
ERROR_COUNT TYP 
ERROR_IG 10°3 

ERROR_MSG 1076 

ERROR_VAL 104 

EXAMPLE TEST 2UN 4-2 
EXCEPTION_FOUND 
EXIT COMMAND 


Se 16 


a1 
2 


TYPES 
37193 


GENERAL DIAGNOSTIC 10 ROUTINE 
GLOBAL DEFINES Let 

GLOBAL VARIABLES las | 
GLOBALS 5-3 

GO CUMMAND 52720 


5-21 
3722 


HALT COMMAND 
He X COMMAND 


| TYPES 
INITIALIZE S74 ee 
INTERFACING A TEST ROUTINE TO BOLT 
INTERNAL FILES TO BOLT 574 
INTRODUCTION it | 

TQ DESCRIPTOR FORMAT 9-8 

IG INTERFACE ROUTINES G2 
IOLEXCEPTION (2) #474 
IG_FAILURE €i) 7"3 
TOLMAX_LRETRY (3) 774 © 
IQ_SUCCESS (0) i 
TOLTIMEOQUT C4) 7h | 


LENGTH COMMAND 3-23 
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FIXED 3 
FIXED 3 


BOOLEAN 8-3 


FIGURE 1 * GAINING ACCESS T9 CEVICES AND RUNNING TESTS 4-10 
FIGURE 2 = JOLT STRUCTURE eat 
FIGURE 3 = INTERFACING A TEST ROUTINE TO BOLT o=2 
FIGURE 4&4 = TEST ROUTINE STRUCTURE o=> 
FIGURE 5 = DIAGNOSTIC [0 INTERATE I= 35 
FILL BUFFER 5 ad 


Cd0_19) 9=4 


BOOLEAN 8-4 


671 


LITERALS AND VALUES. 3°43 2 2 
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LOCK COMMAND 3°25 
LOCK_POQSITIUN 
LOGICAL OP COMMAND 


TYPE: FIXED 


3°25 
COMMAND Seer 
Lo=3 


MAXIMUM 
MESSAGE 
ODT COMMAND 57-23 

OOT TRACE hele 

OP COMMAND 3°29 
~—OPERATING INSTRUCTIONS 
OPERATIUR in4 
OPERATOR SENSTTIVE 


41 
1-4 
PATTERN 1173 
PCAP 9-174 

PCAP TESTING USING 
PCAP TESTING USING 


LOGICAL T/0 COMMANDS 
PHYSICAL {/0 COMMANDS 
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TEST ROUTINE STRUCTURE 
TEST SECTION FRAGMENT 
TEST_ DATA ef 


PFILE 5-5 
POSITION_LOCKED_ON 
PREDEFINED TESTS 4-2 
PRINTER COMMAND 3-30 
PROGRAM STRUCTURE 5-1 
PROGRAM SWITCHES 4-11 


RC_ABORT_SECTION (5 
RC_ABORT_TEST (4) 
RC_CONTINUE (0) 7? 
RC_INPUT_PRESENT (3 
RC_LOCK (1) £472 
RC_TOO_MANY_ERRORS 
RECORDS COMMAND 
RELATED DOCUMENTS 
REPEAT COMMAND 
REQUIRED FILES 
RESTART COMMAND 
RETRY COMMAND 
RETRY OPS 955 
RETRY_OVERRIDE | 


C2) 
ao ie | 

12 
ae 3c 
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S733 
3734 


SECTION 174 =) 
SECTION COMMAND 3°35 
SEND COMMAND 3-36 
SET_UP_DIO_DESCRIPTOR ~ 
SIMPLE_IO 9-6 
STATEMENT 3-2 

SYNTAX ERROR 1-4 


G=8 


(3°37 
TEST 1°74 ee 
TEST ROUTINE EXAMPLE 12-1. 
6-4 
azeh 


TYPE: 


TYPE: 


TYPES, 


(1024) BYTE — 


FIXED 


BOOLEAN 


B74 
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TEST_DESC 
TEST_EXT_RSLT 
TEST_UNIT 623 
TESTS 593 

TFILE 574 

TRACE COMMAND 3233 
TRACE DATA BUFFERS 
TRACE DESCRIPTORS 


TYPE: 
TYPE: 


G=5 
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UNIT 174 3-40 
USE_DEFAULT_DATA 
USE_DEFAULT_LENGTH 
USE_DEFAULT_RECNRDS 
UTILITIES 5-3 

UTILITY PROCEDURE INTERFACE 


TYPE: 
TYPES 
TYPES 
1 ES Bade | 
WAIT_FOR_INPUT i175 


XMN COMMAND 3742 


Ney 


DIO_DESCRIPTOR 


BIT (64) 


BOOLEAN 
BOOLEAN 
SQOLEAN 
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